Gitea MCP connector
Updated
Gitea is a self-hosted Git service for repository hosting, code review, and CI/CD management. The Gitea MCP connector allows AI agents to manage repositories, organizations, and webhooks, as well as automate cron tasks and notifications. It also supports retrieving user and actor information across a Gitea instance, giving teams visibility into their development infrastructure.
Authentication type
- API Key - Requires a static API key to be configured before the agent can connect to the service.
Uses
Use the Gitea MCP connector to perform the following actions:
- Automate repository creation for new teams and organizations in Gitea
- Track and clear unread notifications across development projects
- Provision and remove user accounts as staffing changes occur
- Schedule and trigger recurring maintenance tasks through cron jobs
- Configure webhooks to sync Gitea events with other business systems
- Convert markdown documentation into formatted HTML for internal wikis
- Manage SSH keys for secure developer access to repositories
- Recover unadopted repositories left behind from manual server changes
Example prompts
Use the following example prompts to invoke Gitea MCP connector tools from your AI assistant or Boomi Connect workflow:
Create a new repository called 'inventory-app' under the marketing organization in Gitea.Show me all unread notifications in my Gitea account.Add a new user named Sarah Chen to our Gitea instance.List every organization currently set up in Gitea.Convert this markdown release note into HTML using Gitea.Run the nightly cleanup cron task in Gitea right now.Delete the SSH key for a former employee in Gitea.Check if there are any unadopted repositories sitting on our Gitea server.Set up a webhook so Gitea notifies our chat tool of new commits.Mark all my Gitea notifications as read.
Gitea MCP connector tools
The Gitea MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.
| Tool | Description |
|---|---|
| activitypubPerson | Returns the Person actor for a user |
| activitypubPersonInbox | Send to the inbox |
| adminCronList | List cron tasks |
| adminCronRun | Run cron task |
| adminListHooks | List system's webhooks |
| adminCreateHook | Create a hook |
| adminGetHook | Get a hook |
| adminEditHook | Update a hook |
| adminGetAllOrgs | List all organizations |
| adminUnadoptedList | List unadopted repositories |
| adminDeleteUnadoptedRepository | Delete unadopted files |
| adminAdoptRepository | Adopt unadopted files as a repository |
| adminGetAllUsers | List all users |
| adminCreateUser | Create a user |
| adminDeleteUser | Delete a user |
| adminEditUser | Edit an existing user |
| adminCreatePublicKey | Add a public key on behalf of a user |
| adminDeleteUserPublicKey | Delete a user's public key |
| adminCreateOrg | Create an organization |
| adminCreateRepo | Create a repository on behalf of a user |
| adminDeleteHook | Delete a hook |
| renderMarkdown | Render a markdown document as HTML |
| renderMarkdownRaw | Render raw markdown as HTML |
| getNodeInfo | Returns the nodeinfo of the Gitea application |
| notifyGetList | List users's notification threads |
| notifyReadList | Mark notification threads as read, pinned or unread |
| notifyNewAvailable | Check if unread notifications exist |
| notifyGetThread | Get notification thread by ID |
| notifyReadThread | Mark notification thread as read by ID |
| createOrgRepoDeprecated | Create a repository in an organization |
| orgGetAll | Get list of organizations |
| orgCreate | Create an organization |
| orgDelete | Delete an organization |
| orgGet | Get an organization |
| orgEdit | Edit an organization |
| orgListHooks | List an organization's webhooks |
| orgCreateHook | Create a hook |
| orgDeleteHook | Delete a hook |
| orgGetHook | Get a hook |
| orgEditHook | Update a hook |
| orgListLabels | List an organization's labels |
| orgCreateLabel | Create a label for an organization |
| orgDeleteLabel | Delete a label |
| orgGetLabel | Get a single label |
| orgEditLabel | Update a label |
| orgListMembers | List an organization's members |
| orgDeleteMember | Remove a member from an organization |
| orgIsMember | Check if a user is a member of an organization |
| orgListPublicMembers | List an organization's public members |
| orgConcealMember | Conceal a user's membership |
| orgIsPublicMember | Check if a user is a public member of an organization |
| orgPublicizeMember | Publicize a user's membership |
| orgListRepos | List an organization's repos |
| createOrgRepo | Create a repository in an organization |
| orgListTeams | List an organization's teams |
| orgCreateTeam | Create a team |
| teamSearch | Search for teams within an organization |
| listPackages | Gets all packages of an owner |
| deletePackage | Delete a package |
| getPackage | Gets a package |
| listPackageFiles | Gets all files of a package |
| issueSearchIssues | Search for issues across the repositories that the user has access to |
| repoMigrate | Migrate a remote git repository |
| repoSearch | Search for repositories |
| repoDelete | Delete a repository |
| repoGet | Get a repository |
| repoEdit | Edit a repository's properties. |
| repoGetArchive | Get an archive of a repository |
| repoGetAssignees | Return all users that have write access and can be assigned to issues |
| repoListBranchProtection | List branch protections for a repository |
| repoCreateBranchProtection | Create a branch protections for a repository |
| repoDeleteBranchProtection | Delete a specific branch protection for the repository |
| repoGetBranchProtection | Get a specific branch protection for the repository |
| repoEditBranchProtection | Edit a branch protections for a repository. |
| repoListBranches | List a repository's branches |
| repoCreateBranch | Create a branch |
| repoDeleteBranch | Delete a specific branch from a repository |
| repoGetBranch | Retrieve a specific branch from a repository, including its effective branch protection |
| repoListCollaborators | List a repository's collaborators |
| repoDeleteCollaborator | Delete a collaborator from a repository |
| repoCheckCollaborator | Check if a user is a collaborator of a repository |
| repoAddCollaborator | Add a collaborator to a repository |
| repoGetRepoPermissions | Get repository permissions for a user |
| repoGetAllCommits | Get a list of all commits from a repository |
| repoGetCombinedStatusByRef | Get a commit's combined status, by branch/tag/commit reference |
| repoListStatusesByRef | Get a commit's statuses, by branch/tag/commit reference |
| repoGetContentsList | Gets the metadata of all the entries of the root dir |
| repoDeleteFile | Delete a file in a repository |
| repoGetContents | Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir |
| repoCreateFile | Create a file in a repository |
| repoUpdateFile | Update a file in a repository |
| repoApplyDiffPatch | Apply diff patch to repository |
| repoGetEditorConfig | Get the EditorConfig definitions of a file in a repository |
| listForks | List a repository's forks |
| createFork | Fork a repository |
| GetBlob | Gets the blob of a repository. |
| repoGetSingleCommit | Get a single commit from a repository |
| repoDownloadCommitDiffOrPatch | Get a commit's diff or patch |
| repoGetNote | Get a note corresponding to a single commit from a repository |
| repoListAllGitRefs | Get specified ref or filtered repository's refs |
| repoListGitRefs | Get specified ref or filtered repository's refs |
| GetAnnotatedTag | Gets the tag object of an annotated tag (not lightweight tags) |
| GetTree | Gets the tree of a repository. |
| repoListHooks | List the hooks in a repository |
| repoCreateHook | Create a hook |
| repoListGitHooks | List the Git hooks in a repository |
| repoDeleteGitHook | Delete a Git hook in a repository |
| repoGetGitHook | Get a Git hook |
| repoEditGitHook | Edit a Git hook in a repository |
| repoDeleteHook | Delete a hook in a repository |
| repoGetHook | Get a hook |
| repoEditHook | Edit a hook in a repository |
| repoTestHook | Test a push webhook |
| repoGetIssueTemplates | Get available issue templates for a repository |
| issueListIssues | List a repository's issues |
| issueCreateIssue | Create an issue. |
| issueGetRepoComments | List all comments in a repository |
| issueDeleteComment | Delete a comment |
| issueGetComment | Get a comment |
| issueEditComment | Edit a comment |
| issueListIssueCommentAttachments | List comment's attachments |
| issueDeleteIssueCommentAttachment | Delete a comment attachment |
| issueGetIssueCommentAttachment | Get a comment attachment |
| issueEditIssueCommentAttachment | Edit a comment attachment |
| issueDeleteCommentReaction | Remove a reaction from a comment of an issue |
| issueGetCommentReactions | Get a list of reactions from a comment of an issue |
| issuePostCommentReaction | Add a reaction to a comment of an issue |
| issueDelete | Delete an issue |
| issueGetIssue | Get an issue |
| issueEditIssue | Edit an issue. |
| issueListIssueAttachments | List issue's attachments |
| issueDeleteIssueAttachment | Delete an issue attachment |
| issueGetIssueAttachment | Get an issue attachment |
| issueEditIssueAttachment | Edit an issue attachment |
| issueGetComments | List all comments on an issue |
| issueCreateComment | Add a comment to an issue |
| issueDeleteCommentDeprecated | Delete a comment |
| issueEditCommentDeprecated | Edit a comment |
| issueEditIssueDeadline | Set an issue deadline. |
| issueClearLabels | Remove all labels from an issue |
| issueGetLabels | Get an issue's labels |
| issueAddLabel | Add a label to an issue |
| issueReplaceLabels | Replace an issue's labels |
| issueRemoveLabel | Remove a label from an issue |
| issueDeleteIssueReaction | Remove a reaction from an issue |
| issueGetIssueReactions | Get a list reactions of an issue |
| issuePostIssueReaction | Add a reaction to an issue |
| issueDeleteStopWatch | Delete an issue's existing stopwatch. |
| issueStartStopWatch | Start stopwatch on an issue. |
| issueStopStopWatch | Stop an issue's existing stopwatch. |
| issueSubscriptions | Get users who subscribed on an issue. |
| issueCheckSubscription | Check if user is subscribed to an issue |
| issueDeleteSubscription | Unsubscribe user from issue |
| issueAddSubscription | Subscribe user to issue |
| issueGetCommentsAndTimeline | List all comments and events on an issue |
| issueResetTime | Reset a tracked time of an issue |
| issueTrackedTimes | List an issue's tracked times |
| issueAddTime | Add tracked time to a issue |
| issueDeleteTime | Delete specific tracked time |
| repoListKeys | List a repository's keys |
| repoCreateKey | Add a key to a repository |
| repoDeleteKey | Delete a key from a repository |
| repoGetKey | Get a repository's key by id |
| issueListLabels | Get all of a repository's labels |
| issueCreateLabel | Create a label |
| issueDeleteLabel | Delete a label |
| issueGetLabel | Get a single label |
| issueEditLabel | Update a label |
| repoGetLanguages | Get languages and number of bytes of code written |
| repoGetRawFileOrLFS | Get a file or it's LFS object from a repository |
| issueGetMilestonesList | Get all of a repository's opened milestones |
| issueCreateMilestone | Create a milestone |
| issueDeleteMilestone | Delete a milestone |
| issueGetMilestone | Get a milestone |
| issueEditMilestone | Update a milestone |
| repoMirrorSync | Sync a mirrored repository |
| notifyGetRepoList | List users's notification threads on a specific repo |
| notifyReadRepoList | Mark notification threads as read, pinned or unread on a specific repo |
| repoListPullRequests | List a repo's pull requests |
| repoCreatePullRequest | Create a pull request |
| repoGetPullRequest | Get a pull request |
| repoEditPullRequest | Update a pull request. |
| repoDownloadPullDiffOrPatch | Get a pull request diff or patch |
| repoGetPullRequestCommits | Get commits for a pull request |
| repoGetPullRequestFiles | Get changed files for a pull request |
| repoCancelScheduledAutoMerge | Cancel the scheduled auto merge for the given pull request |
| repoPullRequestIsMerged | Check if a pull request has been merged |
| repoMergePullRequest | Merge a pull request |
| repoDeletePullReviewRequests | Cancel review requests for a pull request |
| repoCreatePullReviewRequests | Create review requests for a pull request |
| repoListPullReviews | List all reviews for a pull request |
| repoCreatePullReview | Create a review to an pull request |
| repoDeletePullReview | Delete a specific review from a pull request |
| repoGetPullReview | Get a specific review for a pull request |
| repoSubmitPullReview | Submit a pending review to an pull request |
| repoGetPullReviewComments | Get a specific review for a pull request |
| repoDismissPullReview | Dismiss a review for a pull request |
| repoUnDismissPullReview | Cancel to dismiss a review for a pull request |
| repoUpdatePullRequest | Merge PR's baseBranch into headBranch |
| repoListPushMirrors | Get all push mirrors of the repository |
| repoAddPushMirror | Add a push mirror to the repository |
| repoPushMirrorSync | Sync all push mirrored repository |
| repoDeletePushMirror | Deletes a push mirror from a repository by remoteName |
| repoGetPushMirrorByRemoteName | Get push mirror of the repository by remoteName |
| repoGetRawFile | Get a file from a repository |
| repoListReleases | List a repo's releases |
| repoCreateRelease | Create a release |
| repoGetLatestRelease | Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at |
| repoDeleteReleaseByTag | Delete a release by tag name |
| repoGetReleaseByTag | Get a release by tag name |
| repoDeleteRelease | Delete a release |
| repoGetRelease | Get a release |
| repoEditRelease | Update a release |
| repoListReleaseAttachments | List release's attachments |
| repoDeleteReleaseAttachment | Delete a release attachment |
| repoGetReleaseAttachment | Get a release attachment |
| repoEditReleaseAttachment | Edit a release attachment |
| repoGetReviewers | Return all users that can be requested to review in this repo |
| repoSigningKey | Get signing-key.gpg for given repository |
| repoListStargazers | List a repo's stargazers |
| repoListStatuses | Get a commit's statuses |
| repoCreateStatus | Create a commit status |
| repoListSubscribers | List a repo's watchers |
| userCurrentDeleteSubscription | Unwatch a repo |
| userCurrentCheckSubscription | Check if the current user is watching a repo |
| userCurrentPutSubscription | Watch a repo |
| repoListTags | List a repository's tags |
| repoCreateTag | Create a new git tag in a repository |
| repoDeleteTag | Delete a repository's tag by name |
| repoGetTag | Get the tag of a repository by tag name |
| repoListTeams | List a repository's teams |
| repoDeleteTeam | Delete a team from a repository |
| repoCheckTeam | Check if a team is assigned to a repository |
| repoAddTeam | Add a team to a repository |
| repoTrackedTimes | List a repo's tracked times |
| userTrackedTimes | List a user's tracked times in a repo |
| repoListTopics | Get list of topics that a repository has |
| repoUpdateTopics | Replace list of topics for a repository |
| repoDeleteTopic | Delete a topic from a repository |
| repoAddTopic | Add a topic to a repository |
| repoTransfer | Transfer a repo ownership |
| acceptRepoTransfer | Accept a repo transfer |
| rejectRepoTransfer | Reject a repo transfer |
| repoCreateWikiPage | Create a wiki page |
| repoDeleteWikiPage | Delete a wiki page |
| repoGetWikiPage | Get a wiki page |
| repoEditWikiPage | Edit a wiki page |
| repoGetWikiPages | Get all wiki pages |
| repoGetWikiPageRevisions | Get revisions of a wiki page |
| generateRepo | Create a repository using a template |
| repoGetByID | Get a repository by id |
| getGeneralAPISettings | Get instance's global settings for api |
| getGeneralAttachmentSettings | Get instance's global settings for Attachment |
| getGeneralRepositorySettings | Get instance's global settings for repositories |
| getGeneralUISettings | Get instance's global settings for ui |
| getSigningKey | Get default signing-key.gpg |
| orgDeleteTeam | Delete a team |
| orgGetTeam | Get a team |
| orgEditTeam | Edit a team |
| orgListTeamMembers | List a team's members |
| orgRemoveTeamMember | Remove a team member |
| orgListTeamMember | List a particular member of team |
| orgAddTeamMember | Add a team member |
| orgListTeamRepos | List a team's repos |
| orgRemoveTeamRepository | Remove a repository from a team |
| orgListTeamRepo | List a particular repo of team |
| orgAddTeamRepository | Add a repository to a team |
| topicSearch | Search topics via keyword |
| userGetCurrent | Get the authenticated user |
| userGetOauth2Application | List the authenticated user's oauth2 applications |
| userCreateOAuth2Application | Creates a new OAuth2 application |
| userDeleteOAuth2Application | Delete an OAuth2 Application |
| userGetOAuth2Application | Get an OAuth2 Application |
| userUpdateOAuth2Application | Update an OAuth2 Application, this includes regenerating the client secret |
| userDeleteEmail | Delete email addresses |
| userListEmails | List the authenticated user's email addresses |
| userAddEmail | Add email addresses |
| userCurrentListFollowers | List the authenticated user's followers |
| userCurrentListFollowing | List the users that the authenticated user is following |
| userCurrentDeleteFollow | Unfollow a user |
| userCurrentCheckFollowing | Check whether a user is followed by the authenticated user |
| userCurrentPutFollow | Follow a user |
| getVerificationToken | Get a Token to verify |
| userVerifyGPGKey | Verify a GPG key |
| userCurrentListGPGKeys | List the authenticated user's GPG keys |
| userCurrentPostGPGKey | Create a GPG key |
| userCurrentDeleteGPGKey | Remove a GPG key |
| userCurrentGetGPGKey | Get a GPG key |
| userCurrentListKeys | List the authenticated user's public keys |
| userCurrentPostKey | Create a public key |
| userCurrentDeleteKey | Delete a public key |
| userCurrentGetKey | Get a public key |
| orgListCurrentUserOrgs | List the current user's organizations |
| userCurrentListRepos | List the repos that the authenticated user owns |
| createCurrentUserRepo | Create a repository |
| getUserSettings | Get user settings |
| updateUserSettings | Update user settings |
| userCurrentListStarred | The repos that the authenticated user has starred |
| userCurrentDeleteStar | Unstar the given repo |
| userCurrentCheckStarring | Whether the authenticated is starring the repo |
| userCurrentPutStar | Star the given repo |
| userGetStopWatches | Get list of all existing stopwatches |
| userCurrentListSubscriptions | List repositories watched by the authenticated user |
| userListTeams | List all the teams a user belongs to |
| userCurrentTrackedTimes | List the current user's tracked times |
| userSearch | Search for users |
| userGet | Get a user |
| userListFollowers | List the given user's followers |
| userListFollowing | List the users that the given user is following |
| userCheckFollowing | Check if one user is following another user |
| userListGPGKeys | List the given user's GPG keys |
| userGetHeatmapData | Get a user's heatmap |
| userListKeys | List the given user's public keys |
| orgListUserOrgs | List a user's organizations |
| orgGetUserPermissions | Get user permissions in organization |
| userListRepos | List the repos owned by the given user |
| userListStarred | The repos that the given user has starred |
| userListSubscriptions | List the repositories watched by a user |
| userGetTokens | List the authenticated user's access tokens |
| userCreateToken | Create an access token |
| userDeleteAccessToken | Delete an access token |
| getVersion | Returns the version of the Gitea application |
