Claude MarketplacesSubmit

gitea-mcp

werebear73/gitea-mcp

Brings Gitea's REST API into MCP so Claude can file issues, triage backlogs, cut releases, and manage pull requests without you switching windows. Works against self-hosted Gitea, Forgejo, and Codeberg instances. You get 20+ tools covering issues, repos, PRs, files, and releases, all authenticated via personal access token. The CLI includes an init command that walks you through config and drops the right JSON into Claude Desktop's settings, plus a doctor command that verifies connectivity before you waste time debugging. If you're running Gitea instead of GitHub and want your assistant to actually interact with your forge, this is the straightforward path.

tools: 21
auth: Secret needed
transport: STDIO
env vars: 5
last updated: May 29, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

create_issue

No parameter schema in public metadata yet.

list_issues

No parameter schema in public metadata yet.

get_issue

No parameter schema in public metadata yet.

update_issue

No parameter schema in public metadata yet.

add_comment

No parameter schema in public metadata yet.

list_repos

No parameter schema in public metadata yet.

list_labels

No parameter schema in public metadata yet.

list_milestones

No parameter schema in public metadata yet.

list_branches

No parameter schema in public metadata yet.

list_pull_requests

No parameter schema in public metadata yet.

get_pull_request

No parameter schema in public metadata yet.

add_comment_on_pr

No parameter schema in public metadata yet.

create_pr

No parameter schema in public metadata yet.

merge_pr

No parameter schema in public metadata yet.

read_file

No parameter schema in public metadata yet.

commit_changes

No parameter schema in public metadata yet.

create_branch

No parameter schema in public metadata yet.

list_releases

No parameter schema in public metadata yet.

create_release

No parameter schema in public metadata yet.

get_server_info

No parameter schema in public metadata yet.

get_server_version

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

GITEA_URL*

Base URL of your Gitea/Forgejo/Codeberg instance

GITEA_TOKEN*secret

Personal access token for the configured instance

GITEA_TIMEOUTdefault: 30

HTTP request timeout in seconds

GITEA_MAX_RETRIESdefault: 3

Retry count for transient failures

GITEA_RETRY_BASE_DELAYdefault: 0.5

Retry backoff base delay in seconds

Readme

gitea-mcp

A Model Context Protocol server for Gitea — lets AI assistants (Claude, ChatGPT, Copilot, and anything else that speaks MCP) read, create, and manage issues, repositories, and releases on any Gitea instance you can reach.

Also works against Forgejo and Codeberg (API-compatible).

Why

Self-hosted Gitea is a popular GitHub alternative for solo developers, small teams, and privacy-conscious organizations. With this MCP server installed, your AI assistant can:

File audit findings or refactor notes as Gitea issues without you leaving the chat
Triage a repo's open issues in natural language
Cut a release at the end of a coding session
Comment on issues across multiple repos in one pass

Features

View the full README on GitHub

Details

Repository: github.com/werebear73/gitea-mcp
Website: github.com/werebear73/gitea-mcp
Package: gitea-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active