Gitea MCP connector

Gitea is a self-hosted Git service that provides repository hosting, code review, and continuous integration and deployment capabilities. The Gitea MCP connector allows AI agents to manage user accounts and organizations, retrieve actor information, and administer system webhooks and cron tasks. It also supports sending messages to user inboxes, listing unadopted repositories, and configuring automated task schedules across your Gitea instance.

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 user and repository provisioning across development teams
• Monitor and manage webhooks to trigger downstream workflows in real time
• Synchronize organization structures and team memberships with identity systems
• Track and respond to notifications and code review threads programmatically
• Create and adopt repositories in bulk to standardize project governance
• Execute scheduled maintenance tasks and cron jobs without manual intervention
• Render markdown documentation as HTML for automated publishing workflows

Example prompts

Use the following example prompts to invoke Gitea MCP connector tools from your AI assistant or Boomi Connect workflow:

• Create a new user account in Gitea for our new developer.
• List all organizations in Gitea and show me their repositories.
• Add a public key to a user's Gitea account so they can authenticate.
• Set up a webhook in Gitea that notifies us when code is pushed.
• Show me all unread notifications in Gitea for the current user.
• Create a new repository in our Gitea organization for the frontend team.
• Delete the webhook that keeps sending failed notifications.
• Adopt all unadopted files as repositories in Gitea.
• Mark all notification threads as read in Gitea.
• Edit a user's profile information in Gitea.

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 profile information for a specified user.
activitypubPersonInbox	Sends a message to a user's inbox for activity processing.
adminCronList	Lists all scheduled cron tasks configured in the system.
adminCronRun	Executes a specified cron task immediately on demand.
adminListHooks	Lists all system-wide webhooks configured for the application.
adminCreateHook	Creates a new system-wide webhook for event notifications.
adminGetHook	Retrieves details about a specific system webhook.
adminEditHook	Updates the configuration settings of an existing system webhook.
adminGetAllOrgs	Lists all organizations in the Gitea instance.
adminUnadoptedList	Lists repositories that exist but are not yet adopted.
adminDeleteUnadoptedRepository	Deletes unadopted repository files from the system.
adminAdoptRepository	Adopts unadopted files and registers them as a repository.
adminGetAllUsers	Lists all user accounts in the Gitea instance.
adminCreateUser	Creates a new user account with specified credentials.
adminDeleteUser	Removes a user account from the system.
adminEditUser	Modifies the settings and properties of an existing user.
adminCreatePublicKey	Adds a public key to a user's account as administrator.
adminDeleteUserPublicKey	Removes a public key from a user's account.
adminCreateOrg	Creates a new organization in the Gitea instance.
adminCreateRepo	Creates a new repository on behalf of a specified user.
adminDeleteHook	Removes a system webhook from the application.
renderMarkdown	Converts a markdown document to formatted HTML output.
renderMarkdownRaw	Converts raw markdown text to formatted HTML output.
getNodeInfo	Returns server information and software details for the instance.
notifyGetList	Lists all notification threads for the current user.
notifyReadList	Marks multiple notifications as read, pinned, or unread.
notifyNewAvailable	Checks whether the user has unread notifications.
notifyGetThread	Retrieves a specific notification thread by identifier.
notifyReadThread	Marks a single notification thread as read.
createOrgRepoDeprecated	Creates a new repository within a specified 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. Only fields that are set will be changed.
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. Only fields that are set will be changed.
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. If using deadline only the date will be taken into account, and time of day ignored.
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. If using deadline only the date will be taken into account, and time of day ignored.
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. If set to null, the deadline is deleted. If using deadline only the date will be taken into accou.
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. If using deadline only the date will be taken into account, and time of day ignored.
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.