The Gitea connector lets your AI agent act in each user's Gitea account. Each user connects their own Gitea API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 35 · 20 · 535 read20 write5 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Gitea connection
In AgentKit > Connections, create a Gitea connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'gitea'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Gitea:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'gitea_issues_search',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "gitea"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Gitea:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="gitea_issues_search",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Gitea credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolgitea_branch_getGet one branch with its latest commit and protection settings.Read-onlyGet Branch
Get one branch with its latest commit and protection settings. Returns the branch object. Get names from gitea_branches_list.
Inputs
branchstringrequired- Name of the branch. Example: main.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_branches_listList a repository's branches with their latest commit and protection status.Read-onlyList Branches
List a repository's branches with their latest commit and protection status. Returns branch objects. Use gitea_branch_get for one branch.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
qstring- Search keyword. Example: hello.
gitea_collaborators_listList the users with direct access to a repository.Read-onlyList Collaborators
List the users with direct access to a repository. Returns user objects. Use gitea_collaborator_add to give someone access.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_commit_getGet one commit by SHA with its message, author, parents, files and stats.Read-onlyGet Commit
Get one commit by SHA with its message, author, parents, files and stats. Returns the commit object. Get SHAs from gitea_commits_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
shastringrequired- SHA of the commit. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
filesboolean- include a list of affected files for every commit (disable for speedup, default 'true'). Example: true.
statboolean- include diff stats for every commit (disable for speedup, default 'true'). Example: true.
verificationboolean- include verification for every commit (disable for speedup, default 'true'). Example: true.
gitea_commits_listList commits on a branch or ref, optionally only those touching a path or in a time range.Read-onlyList Commits
List commits on a branch or ref, optionally only those touching a path or in a time range. Returns commit objects with SHA, message, author and stats. Use gitea_commit_get for one commit.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
filesboolean- include a list of affected files for every commit (disable for speedup, default 'true'). Example: true.
limitinteger- Number of results per page. Example: 25.
notstring- commits that match the given specifier will not be listed. Example: release-1.0.
pageinteger- Page number of results, starting at 1. Example: 1.
pathstring- Only return commits that touch this file or directory path. Example: docs/README.md.
shastring- Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
sincestring- Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
statboolean- include diff stats for every commit (disable for speedup, default 'true'). Example: true.
untilstring- Only commits before this date will be returned (ISO 8601 format). Example: 2026-01-15T09:30:00Z.
verificationboolean- include verification for every commit (disable for speedup, default 'true'). Example: true.
gitea_contents_getGet a file's metadata and base64 content, or a directory's entries, at a path and ref.Read-onlyGet File or Directory
Get a file's metadata and base64 content, or a directory's entries, at a path and ref. Returns the content object including the blob sha needed by gitea_file_update and gitea_file_delete.
Inputs
filepathstringrequired- Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
refstring- Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.
gitea_issue_comments_listList the comments on an issue or pull request.Read-onlyList Issue Comments
List the comments on an issue or pull request. Returns comment objects with author, body and time. Get issue numbers from gitea_issues_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
beforestring- Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
sincestring- Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
gitea_issue_getGet one issue (or pull request) by number with its body, state, labels, assignees and milestone.Read-onlyGet Issue
Get one issue (or pull request) by number with its body, state, labels, assignees and milestone. Returns the issue object. Get issue numbers from gitea_issues_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_issues_listList a repository's issues or pull requests, filtered by state, labels, milestone, author, assignee or keyword.Read-onlyList Issues
List a repository's issues or pull requests, filtered by state, labels, milestone, author, assignee or keyword. Returns issue objects. Use gitea_issues_search to search across repositories and gitea_issue_get for one issue.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
assigned_bystring- Only show items for which the given user is assigned. Example: jdoe.
beforestring- Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
created_bystring- Only show items which were created by the given user. Example: jdoe.
labelsstring- Comma-separated label names to filter by. Example: bug,ui.
limitinteger- Number of results per page. Example: 25.
mentioned_bystring- Only show items in which the given user was mentioned. Example: jdoe.
milestonesstring- comma separated list of milestone names or ids. It uses names and fall back to ids. Fetch only issues that have any of this milestones. Non existent milestones are discarded. Example: v1.2.
pageinteger- Page number of results, starting at 1. Example: 1.
qstring- Search keyword. Example: hello.
sincestring- Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.one of
closedopenall typestring- Only return issues or pulls. Example: issues.one of
issuespulls
gitea_issues_searchSearch issues and pull requests across every repository the token can see, filtered by state, labels, keyword, type, owner or involvement.Read-onlySearch Issues
Search issues and pull requests across every repository the token can see, filtered by state, labels, keyword, type, owner or involvement. Returns issue objects with their repository. Use gitea_issues_list inside one repository.
Inputs
assignedboolean- Filter issues or pulls assigned to the authenticated user. Example: false.
beforestring- Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
createdboolean- Filter issues or pulls created by the authenticated user. Example: false.
created_bystring- Only show items which were created by the given user. Example: jdoe.
labelsstring- Comma-separated label names to filter by. Example: bug,ui.
limitinteger- Number of results per page. Example: 25.
mentionedboolean- Filter issues or pulls mentioning the authenticated user. Example: false.
milestonesstring- Comma-separated list of milestone names. Fetch only issues that have any of these milestones. Non existent milestones are discarded. Example: v1.2.
ownerstring- Owner of the repository: a user name or organization name. Example: octo-org.
pageinteger- Page number of results, starting at 1. Example: 1.
qstring- Search keyword. Example: hello.
review_requestedboolean- Filter pull requests where the authenticated user's review was requested. Example: false.
reviewedboolean- Filter pull requests reviewed by the authenticated user. Example: false.
sincestring- Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.one of
openclosedall teamstring- Filter by team (requires organization owner parameter). Example: backend.
typestring- Only return issues or pulls. Example: issues.one of
issuespulls
gitea_labels_listList a repository's labels.Read-onlyList Labels
List a repository's labels. Returns label objects with ID, name, color and description. Use the IDs with gitea_issue_create and gitea_issue_labels_add.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_milestones_listList a repository's milestones, optionally by state or name.Read-onlyList Milestones
List a repository's milestones, optionally by state or name. Returns milestone objects with progress counts. Use the IDs with gitea_issue_create.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
namestring- Name. Example: hello-world.
pageinteger- Page number of results, starting at 1. Example: 1.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.
gitea_notifications_listList the token user's notification threads (issues, pull requests, commits, releases), unread by default.Read-onlyList Notifications
List the token user's notification threads (issues, pull requests, commits, releases), unread by default. Returns notification threads with their subject and repository.
Inputs
allboolean- If true, show notifications marked as read. Default value is false. Example: true.
beforestring- Only return items updated before this time (ISO 8601). Example: 2026-02-01T00:00:00Z.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
sincestring- Only return items updated after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
status_typesarray- Show notifications with the provided status types. Options are: unread, read and/or pinned. Defaults to unread & pinned. Example: ["unread"]
subject_typearray- filter notifications by subject type. Example: ["issues"]
gitea_org_getGet one organization with its description, website, visibility and settings.Read-onlyGet Organization
Get one organization with its description, website, visibility and settings. Returns the organization object. Get names from gitea_orgs_list.
Inputs
orgstringrequired- Name of the organization. Example: octo-org.
gitea_org_members_listList an organization's members (public members only unless the token's user is a member).Read-onlyList Organization Members
List an organization's members (public members only unless the token's user is a member). Returns user objects. Get organization names from gitea_orgs_list.
Inputs
orgstringrequired- Name of the organization. Example: octo-org.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_org_repos_listList an organization's repositories.Read-onlyList Organization Repositories
List an organization's repositories. Returns repository objects. Get organization names from gitea_orgs_list.
Inputs
orgstringrequired- Name of the organization. Example: octo-org.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_org_teams_listList an organization's teams with their permissions.Read-onlyList Organization Teams
List an organization's teams with their permissions. Returns team objects. Get organization names from gitea_orgs_list.
Inputs
orgstringrequired- Name of the organization. Example: octo-org.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_orgs_listList the organizations on the Gitea instance that the token can see.Read-onlyList Organizations
List the organizations on the Gitea instance that the token can see. Returns organization objects. Use gitea_user_orgs_list for the token user's own organizations.
Inputs
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_pull_files_listList the files a pull request changes, with additions, deletions and status.Read-onlyList Pull Request Files
List the files a pull request changes, with additions, deletions and status. Returns changed file objects. Get pull request numbers from gitea_pulls_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
skip_tostring- Skip to this file path in the list of changed files. Example: src/app.go.
whitespacestring- How whitespace changes are shown: ignore-all, ignore-change, ignore-eol or show-all. Example: ignore-all.one of
ignore-allignore-changeignore-eolshow-all
gitea_pull_getGet one pull request by number with its head and base, mergeable flag, state and review requests.Read-onlyGet Pull Request
Get one pull request by number with its head and base, mergeable flag, state and review requests. Returns the pull request object. Get pull request numbers from gitea_pulls_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_pull_reviews_listList the reviews on a pull request with state (approved, request changes, comment) and body.Read-onlyList Pull Request Reviews
List the reviews on a pull request with state (approved, request changes, comment) and body. Returns review objects. Get pull request numbers from gitea_pulls_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_pulls_listList a repository's pull requests, filtered by state, base branch, labels, milestone or poster, with sorting.Read-onlyList Pull Requests
List a repository's pull requests, filtered by state, base branch, labels, milestone or poster, with sorting. Returns pull request objects. Use gitea_pull_get for one pull request.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
base_branchstring- Filter by target base branch of the pull request. Example: main.
labelsarray- Only return pull requests with these label IDs. Example: [1, 2]
limitinteger- Number of results per page. Example: 25.
milestoneinteger- ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
pageinteger- Page number of results, starting at 1. Example: 1.
posterstring- Only return pull requests opened by this user. Example: jdoe.
sortstring- Sort order of the results. Example: recentupdate.one of
oldestrecentupdaterecentcloseleastupdatemostcommentleastcommentpriority statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.one of
openclosedall
gitea_release_getGet one release by ID.Read-onlyGet Release
Get one release by ID. Returns the release with its notes and assets. Get IDs from gitea_releases_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
release_idintegerrequired- ID of the release. Example: 345.
repostringrequired- Name of the repository. Example: hello-world.
gitea_release_latest_getGet the most recent published release that is not a draft or pre-release.Read-onlyGet Latest Release
Get the most recent published release that is not a draft or pre-release. Returns the release object. Use gitea_releases_list for all releases.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_releases_listList a repository's releases, optionally drafts or pre-releases only.Read-onlyList Releases
List a repository's releases, optionally drafts or pre-releases only. Returns release objects with notes and assets. Use gitea_release_latest_get for the newest release.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
draftboolean- filter (exclude / include) drafts, if you don't have repo write access none will show. Example: true.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
pre_releaseboolean- filter (exclude / include) pre-releases. Example: true.
tag_filterstring- filter releases by tag. supports "*" as a wildcard (for example: v1*, *beta, *rc*). Example: v1.
gitea_repo_forks_listList the forks of a repository.Read-onlyList Forks
List the forks of a repository. Returns repository objects. Get repositories from gitea_repos_search or gitea_user_repos_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_repo_getGet one repository with its description, default branch, visibility, counts and clone URLs.Read-onlyGet Repository
Get one repository with its description, default branch, visibility, counts and clone URLs. Get repositories from gitea_repos_search or gitea_user_repos_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_repos_searchSearch the repositories visible to the token by keyword, owner, topic or type, with sorting.Read-onlySearch Repositories
Search the repositories visible to the token by keyword, owner, topic or type, with sorting. Returns matching repositories. Use gitea_repo_get for one repository.
Inputs
archivedboolean- true archives the repository (read-only); false unarchives it. Example: true.
exclusiveboolean- true makes the label exclusive within its scope (labels named scope/name), so an issue can only have one of them. Example: false.
include_descboolean- include search of keyword within repository description. Example: true.
is_privateboolean- show only pubic, private or all repositories (defaults to all). Example: true.
limitinteger- Number of results per page. Example: 25.
modestring- type of repository to search for. Supported values are "fork", "source", "mirror" and "collaborative". Example: source.
orderstring- sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not specified. Example: desc.
pageinteger- Page number of results, starting at 1. Example: 1.
priority_owner_idinteger- repo owner to prioritize in the results. Example: 7.
privateboolean- true makes the repository private. Example: false.
qstring- Search keyword. Example: hello.
sortstring- Sort order of the results. Example: updated.
team_idinteger- search only for repos that belong to the given team id. Example: 4.
templateboolean- true marks the repository as a template. Example: false.
topicboolean- Limit search to repositories with keyword as topic. Example: false.
gitea_user_getGet the user the access token belongs to.Read-onlyGet Current User
Get the user the access token belongs to. Returns the user's login, name, email and admin flag. Use gitea_user_get_by_name for another user.
Inputs
This tool takes no inputs.
gitea_user_get_by_nameGet a user by login.Read-onlyGet User
Get a user by login. Returns the user's profile. Use gitea_users_search to find logins.
Inputs
usernamestringrequired- User name (login) of the user. Example: jdoe.
gitea_user_orgs_listList the organizations the token's user belongs to.Read-onlyList My Organizations
List the organizations the token's user belongs to. Returns organization objects. Use gitea_orgs_list for every organization on the instance.
Inputs
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_user_repos_listList the repositories the token's user owns.Read-onlyList My Repositories
List the repositories the token's user owns. Returns repository objects with full names, URLs and settings. Use gitea_repos_search to search all visible repositories.
Inputs
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
gitea_users_searchSearch users by keyword in their login, name or email.Read-onlySearch Users
Search users by keyword in their login, name or email. Returns matching user objects. Use gitea_user_get_by_name when you know the login.
Inputs
limitinteger- Number of results per page. Example: 25.
pageinteger- Page number of results, starting at 1. Example: 1.
qstring- Search keyword. Example: hello.
gitea_version_getGet the version of the Gitea server.Read-onlyGet Gitea Version
Get the version of the Gitea server. Returns the version string. Use it to check what the instance supports or to test the connection.
Inputs
This tool takes no inputs.
gitea_branch_createCreate a branch from an existing branch, tag or commit (old_ref_name).WriteCreate Branch
Create a branch from an existing branch, tag or commit (old_ref_name). Returns the new branch. Get names from gitea_branches_list.
Inputs
new_branch_namestringrequired- Name of the branch to create. Example: feature/login-fix.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
old_ref_namestring- Branch, tag or commit SHA to create the branch from. Defaults to the default branch. Example: main.
gitea_collaborator_addGive a user direct access to a repository with read, write or admin permission.WriteAdd Collaborator
Give a user direct access to a repository with read, write or admin permission. Returns an empty response. Find logins with gitea_users_search.
- Idempotent
Inputs
collaboratorstringrequired- Login of the user to add. Example: jdoe.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
permissionstring- Permission level to grant the collaborator. Example: write.one of
readwriteadmin
gitea_file_createCreate a new file with base64 content and commit it to a branch (or a new branch).WriteCreate File
Create a new file with base64 content and commit it to a branch (or a new branch). Returns the file and commit. Use gitea_file_update to change an existing file.
Inputs
contentstringrequired- New file content, base64-encoded. Example: IyBIZWxsbyBXb3JsZAo=.
filepathstringrequired- Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
authorobject- Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
branchstring- Name of the branch. Example: main.
committerobject- Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
datesobject- Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
force_pushboolean- force_push (optional) will do a force-push if the new branch already exists. Example: true.
messagestring- Commit message. Gitea writes a default one when empty. Example: Update README.
new_branchstring- Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
signoffboolean- Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.
gitea_file_updateReplace an existing file's content (base64) and commit it, optionally moving it from from_path.WriteUpdate File
Replace an existing file's content (base64) and commit it, optionally moving it from from_path. Returns the file and commit. Needs the current blob sha from gitea_contents_get.
- Idempotent
Inputs
contentstringrequired- New file content, base64-encoded. Example: IyBIZWxsbyBXb3JsZAo=.
filepathstringrequired- Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
authorobject- Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
branchstring- Name of the branch. Example: main.
committerobject- Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
datesobject- Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
force_pushboolean- force_push (optional) will do a force-push if the new branch already exists. Example: true.
from_pathstring- from_path (optional) is the path of the original file which will be moved/renamed to the path in the URL. Example: docs/OLD.md.
messagestring- Commit message. Gitea writes a default one when empty. Example: Update README.
new_branchstring- Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
shastring- Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
signoffboolean- Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.
gitea_issue_comment_createAdd a comment to an issue or pull request.WriteComment on Issue
Add a comment to an issue or pull request. Returns the new comment. Get issue numbers from gitea_issues_list.
Inputs
bodystringrequired- Text body (Markdown). Example: Fixes the login redirect loop.
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_issue_comment_updateEdit the body of an issue or pull request comment.WriteUpdate Issue Comment
Edit the body of an issue or pull request comment. Returns the updated comment. Get comment IDs from gitea_issue_comments_list.
Inputs
bodystringrequired- Text body (Markdown). Example: Fixes the login redirect loop.
comment_idintegerrequired- ID of the comment. Example: 345.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_issue_createOpen an issue with a title, body, assignees, labels, milestone and due date.WriteCreate Issue
Open an issue with a title, body, assignees, labels, milestone and due date. Returns the new issue with its number. Get label IDs from gitea_labels_list and milestone IDs from gitea_milestones_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
titlestringrequired- Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
assigneestring- User name to assign (deprecated in favour of assignees). Example: jdoe.
assigneesarray- User names to assign. Example: ["jdoe"]
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
closedboolean- true creates the issue already closed. Example: true.
due_datestring- Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
labelsarray- IDs of the labels to put on the issue. Example: [1, 2]
milestoneinteger- ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
projectsarray- IDs of Gitea projects to add the issue to. Example: [1, 2]
refstring- Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.
gitea_issue_labels_addAdd labels to an issue or pull request, keeping the existing ones.WriteAdd Labels to Issue
Add labels to an issue or pull request, keeping the existing ones. Returns the issue's labels. Get label IDs or names from gitea_labels_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
labelsarray- Labels to add, as label IDs or names. Example: ["bug", 3]
gitea_issue_updateEdit an issue: title, body, assignees, milestone, due date, or close and reopen it with state.WriteUpdate Issue
Edit an issue: title, body, assignees, milestone, due date, or close and reopen it with state. Returns the updated issue. Get issue numbers from gitea_issues_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
assigneestring- User name to assign (deprecated in favour of assignees). Example: jdoe.
assigneesarray- User names to assign. Example: ["jdoe"]
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
content_versioninteger- The current version of the issue content to detect conflicts during editing. Example: 10.
due_datestring- Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
milestoneinteger- ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
projectsarray- IDs of Gitea projects to add the issue to. Example: [1, 2]
refstring- Branch, tag or commit to read from. Defaults to the repository's default branch. Example: main.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.
titlestring- Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
unset_due_dateboolean- true removes the due date. Example: true.
gitea_label_createCreate a label in a repository.WriteCreate Label
Create a label in a repository. Returns the new label. Use gitea_labels_list to see existing labels.
Inputs
colorstringrequired- Label color as a hex code, for example #ee0701. Example: #ee0701.
namestringrequired- Name. Example: needs-triage.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
descriptionstring- Short description. Example: Issue still needs triage.
exclusiveboolean- true makes the label exclusive within its scope (labels named scope/name), so an issue can only have one of them. Example: false.
is_archivedboolean- true creates the label archived. Example: false.
gitea_milestone_createCreate a milestone with a title, description and due date.WriteCreate Milestone
Create a milestone with a title, description and due date. Returns the new milestone. Use gitea_milestones_list to see existing ones.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
descriptionstring- Short description. Example: Login and SSO fixes.
due_onstring- Deadline is the due date for the milestone. Example: 2026-03-31T00:00:00Z.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.one of
openclosed titlestring- Title of the issue, pull request or milestone. Example: v1.2.
gitea_org_repo_createCreate a repository in an organization the token's user can create repositories in.WriteCreate Organization Repository
Create a repository in an organization the token's user can create repositories in. Returns the new repository. Get organization names from gitea_user_orgs_list.
Inputs
namestringrequired- Name. Example: hello-world.
orgstringrequired- Name of the organization. Example: octo-org.
auto_initboolean- Whether the repository should be auto-initialized? Example: true.
default_branchstring- DefaultBranch of the repository (used when initializes and in template). Example: main.
descriptionstring- Short description. Example: Internal tools for the platform team.
gitignoresstring- Comma-separated .gitignore templates to add, for example Go,Node. Example: Go.
issue_labelsstring- Label set to create in the new repository, for example Default. Example: Default.
licensestring- License template to add, for example MIT. Example: MIT.
object_format_namestring- ObjectFormatName of the underlying git repository, empty string for default (sha1). Example: sha1.one of
sha1sha256 privateboolean- true makes the repository private. Example: false.
readmestring- README template to add, for example Default (used with auto_init). Example: Default.
templateboolean- true marks the repository as a template. Example: false.
trust_modelstring- Commit signature trust model: default, collaborator, committer or collaboratorcommitter. Example: default.one of
defaultcollaboratorcommittercollaboratorcommitter
gitea_pull_createOpen a pull request from a head branch into a base branch, with title, body, assignees, labels, milestone and reviewers.WriteCreate Pull Request
Open a pull request from a head branch into a base branch, with title, body, assignees, labels, milestone and reviewers. Returns the new pull request. Get branches from gitea_branches_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
allow_maintainer_editboolean- true lets maintainers push to the pull request branch. Example: true.
assigneestring- User name to assign (deprecated in favour of assignees). Example: jdoe.
assigneesarray- User names to assign. Example: ["jdoe"]
basestring- Branch the pull request merges into, for example main. Example: main.
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
due_datestring- Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
headstring- Branch with the changes, for example feature/login-fix (user:branch for a fork). Example: feature/login-fix.
labelsarray- Comma-separated label names to filter by. Example: [1, 2]
milestoneinteger- ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
reviewersarray- User names to request reviews from. Example: ["jdoe"]
team_reviewersarray- Team names to request reviews from. Example: ["backend"]
titlestring- Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
gitea_pull_mergeMerge a pull request with a merge style (merge, rebase, squash and more), optionally deleting the branch afterwards or merging when checks succeed.WriteMerge Pull Request
Merge a pull request with a merge style (merge, rebase, squash and more), optionally deleting the branch afterwards or merging when checks succeed. Returns an empty response on success. Check gitea_pull_get for mergeable first.
Inputs
dostringrequired- Do. Example: merge.one of
mergerebaserebase-mergesquashfast-forward-onlymanually-merged indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
delete_branch_after_mergeboolean- true deletes the head branch after the merge. Example: true.
force_mergeboolean- true merges even if required checks have not passed (needs admin rights). Example: true.
head_commit_idstring- Expected head commit SHA; the merge fails if the branch moved since. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
merge_commit_idstring- Merge Commit ID. Example: a1b2c3d4.
merge_message_fieldstring- Message body of the merge commit. Example: Merge login fix.
merge_title_fieldstring- Title of the merge commit. Example: Merge pull request #12.
merge_when_checks_succeedboolean- true schedules the merge to happen automatically once checks pass. Example: true.
gitea_pull_review_createSubmit a review on a pull request: approve, request changes or comment, with an optional body and inline comments.WriteReview Pull Request
Submit a review on a pull request: approve, request changes or comment, with an optional body and inline comments. Returns the review. Get pull request numbers from gitea_pulls_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
commentsarray- Inline review comments, each with a file path, a line position (new_position or old_position) and a body. Example: [{"path": "src/app.go", "new_position": 12, "body": "Please handle the error here."}]
commit_idstring- SHA of the commit the review applies to. Defaults to the latest commit. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
eventstring- Review result: APPROVED, REQUEST_CHANGES or COMMENT. Example: COMMENT.one of
APPROVEDPENDINGCOMMENTREQUEST_CHANGESREQUEST_REVIEW
gitea_pull_updateEdit a pull request: title, body, base branch, assignees, labels, milestone, due date, or close and reopen it with state.WriteUpdate Pull Request
Edit a pull request: title, body, base branch, assignees, labels, milestone, due date, or close and reopen it with state. Returns the updated pull request. Get pull request numbers from gitea_pulls_list.
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
allow_maintainer_editboolean- true lets maintainers push to the pull request branch. Example: true.
assigneestring- User name to assign (deprecated in favour of assignees). Example: jdoe.
assigneesarray- User names to assign. Example: ["jdoe"]
basestring- Branch the pull request merges into, for example main. Example: main.
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
content_versioninteger- The current version of the pull request content to detect conflicts during editing. Example: 10.
due_datestring- Due date (ISO 8601), for example 2026-03-31T00:00:00Z. Example: 2026-01-15T09:30:00Z.
labelsarray- Comma-separated label names to filter by. Example: [1, 2]
milestoneinteger- ID of the milestone. Get IDs from gitea_milestones_list. Example: 3.
statestring- State to filter by or set: open or closed (all is allowed on list tools). Example: open.
titlestring- Title of the issue, pull request or milestone. Example: Login redirect loops on Safari.
unset_due_dateboolean- true removes the due date. Example: true.
gitea_release_createCreate a release for a tag (creating the tag from target_commitish if needed), as a draft or pre-release if wanted.WriteCreate Release
Create a release for a tag (creating the tag from target_commitish if needed), as a draft or pre-release if wanted. Returns the new release. Get tags from gitea_tags_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
tag_namestringrequired- Tag the release is for, for example v1.2.0. Created if it does not exist. Example: v1.2.0.
bodystring- Text body (Markdown). Example: Fixes the login redirect loop.
draftboolean- Whether to create the release as a draft. Example: true.
namestring- Name. Example: hello-world.
prereleaseboolean- Whether to mark the release as a prerelease. Example: true.
tag_messagestring- Message of the annotated tag created for the release. Example: Release v1.2.0.
target_commitishstring- Branch or commit to create the tag from when the tag does not exist yet. Example: main.
gitea_repo_createCreate a repository owned by the token's user, optionally initialised with a README, license and .gitignore.WriteCreate Repository
Create a repository owned by the token's user, optionally initialised with a README, license and .gitignore. Returns the new repository. Use gitea_org_repo_create for an organization.
Inputs
namestringrequired- Name. Example: hello-world.
auto_initboolean- Whether the repository should be auto-initialized? Example: true.
default_branchstring- DefaultBranch of the repository (used when initializes and in template). Example: main.
descriptionstring- Short description. Example: Internal tools for the platform team.
gitignoresstring- Comma-separated .gitignore templates to add, for example Go,Node. Example: Go.
issue_labelsstring- Label set to create in the new repository, for example Default. Example: Default.
licensestring- License template to add, for example MIT. Example: MIT.
object_format_namestring- ObjectFormatName of the underlying git repository, empty string for default (sha1). Example: sha1.one of
sha1sha256 privateboolean- true makes the repository private. Example: false.
readmestring- README template to add, for example Default (used with auto_init). Example: Default.
templateboolean- true marks the repository as a template. Example: false.
trust_modelstring- Commit signature trust model: default, collaborator, committer or collaboratorcommitter. Example: default.one of
defaultcollaboratorcommittercollaboratorcommitter
gitea_repo_forkFork a repository into the token's user account or an organization.WriteFork Repository
Fork a repository into the token's user account or an organization. Returns the new fork (Gitea may finish copying in the background). Get repositories from gitea_repos_search or gitea_user_repos_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
namestring- Name. Example: hello-world.
organizationstring- organization name, if forking into an organization. Example: octo-org.
gitea_repo_updateUpdate a repository's settings: name, description, website, visibility, default branch, archived flag, enabled units and merge options.WriteUpdate Repository
Update a repository's settings: name, description, website, visibility, default branch, archived flag, enabled units and merge options. Returns the updated repository. Get repositories from gitea_repos_search or gitea_user_repos_list.
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
allow_merge_commitsboolean- either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. Example: true.
allow_rebaseboolean- either true to allow rebase-merging pull requests, or false to prevent rebase-merging. Example: true.
allow_squash_mergeboolean- either true to allow squash-merging pull requests, or false to prevent squash-merging. Example: true.
archivedboolean- true archives the repository (read-only); false unarchives it. Example: true.
default_branchstring- sets the default branch for this repository. Example: main.
default_delete_branch_after_mergeboolean- set to true to delete pr branch after merge by default. Example: true.
default_merge_stylestring- set to a merge style to be used by this repository: "merge", "rebase", "rebase-merge", "squash", or "fast-forward-only". Example: merge.
descriptionstring- Short description. Example: Internal tools for the platform team.
has_actionsboolean- either true to enable actions unit, or false to disable them. Example: true.
has_issuesboolean- either true to enable issues for this repository or false to disable them. Example: true.
has_projectsboolean- either true to enable project unit, or false to disable them. Example: true.
has_pull_requestsboolean- either true to allow pull requests, or false to prevent pull request. Example: true.
has_releasesboolean- either true to enable releases unit, or false to disable them. Example: true.
has_wikiboolean- either true to enable the wiki for this repository or false to disable it. Example: true.
namestring- Name. Example: hello-world.
privateboolean- true makes the repository private. Example: false.
templateboolean- true marks the repository as a template. Example: false.
websitestring- a URL with more information about the repository. Example: https://example.com.
gitea_branch_deleteDelete a branch (not the default or a protected branch).DestructiveDelete Branch
Delete a branch (not the default or a protected branch). Returns an empty response. Get names from gitea_branches_list.
- Idempotent
Inputs
branchstringrequired- Name of the branch. Example: main.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_file_deleteDelete a file and commit the change to a branch.DestructiveDelete File
Delete a file and commit the change to a branch. Returns the commit. Needs the current blob sha from gitea_contents_get.
- Idempotent
Inputs
filepathstringrequired- Path of the file inside the repository, for example README.md or docs/guide.md for a nested file. Example: README.md.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
shastringrequired- Blob SHA of the file being replaced or deleted. Get it from gitea_contents_get. Example: 3a0f86fb8db8eea7ccbb9a95f325ddbedfb25e15.
authorobject- Commit author as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
branchstring- Name of the branch. Example: main.
committerobject- Committer as an object with name and email. Defaults to the token's user. Example: {"name": "Jane Doe", "email": "jane@example.com"}
datesobject- Author and committer dates as an object with author and committer timestamps (ISO 8601). Example: {"author": "2026-01-15T09:30:00Z", "committer": "2026-01-15T09:30:00Z"}
force_pushboolean- force_push (optional) will do a force-push if the new branch already exists. Example: true.
messagestring- Commit message. Gitea writes a default one when empty. Example: Update README.
new_branchstring- Create this new branch from branch and commit to it. Leave empty to commit to branch. Example: docs-update.
signoffboolean- Add a Signed-off-by trailer by the committer at the end of the commit log message. Example: true.
gitea_issue_comment_deleteDelete an issue or pull request comment.DestructiveDelete Issue Comment
Delete an issue or pull request comment. Returns an empty response. Get comment IDs from gitea_issue_comments_list.
- Idempotent
Inputs
comment_idintegerrequired- ID of the comment. Example: 345.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_issue_label_removeRemove one label from an issue or pull request.DestructiveRemove Label from Issue
Remove one label from an issue or pull request. Returns an empty response. Get label IDs from gitea_labels_list.
- Idempotent
Inputs
indexintegerrequired- Number of the issue or pull request in the repository (the #number shown in Gitea). Example: 12.
label_idintegerrequired- ID of the label to remove. Example: 3.
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
gitea_repo_deletePermanently delete a repository with all its issues, pull requests and history.DestructiveDelete Repository
Permanently delete a repository with all its issues, pull requests and history. Returns an empty response. Get repositories from gitea_repos_search or gitea_user_repos_list.
- Idempotent
Inputs
ownerstringrequired- Owner of the repository: a user name or organization name. Example: octo-org.
repostringrequired- Name of the repository. Example: hello-world.
No tools match.