gitea-mcp
Rank #59,053io.github.werebear73/gitea-mcp
Model Context Protocol server for Gitea (and Forgejo, Codeberg).
What you can do with gitea-mcp
gitea-mcp is a Model Context Protocol (MCP) server published by werebear73. It ranks #59,053 of 167,945 active servers on MCP Toplist, and its repository has 2 GitHub stars. gitea-mcp is listed across 3 registries — Official MCP, Glama and PulseMCP, with 1 tracked version. It was first listed on May 29, 2026 and most recently updated on May 29, 2026.
Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.
What gitea-mcp can and cannot do
Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.
What you need before using gitea-mcp
The registry listing declares required configuration before first use — typically an API key, token or connection string set via environment variables.
Declared by Glama, last synced Nov 3, 2026. Not independently verified by MCP Toplist.
- GITEA_URL · required
- GITEA_TOKEN · required
- GITEA_TIMEOUT · optional
- GITEA_MAX_RETRIES · optional
- GITEA_RETRY_BASE_DELAY · optional
Connect gitea-mcp and confirm it works
claude mcp add gitea-mcp -e "GITEA_URL=<your GITEA_URL>" -e "GITEA_TOKEN=<your GITEA_TOKEN>" -e "GITEA_TIMEOUT=<your GITEA_TIMEOUT>" -e "GITEA_MAX_RETRIES=<your GITEA_MAX_RETRIES>" -e "GITEA_RETRY_BASE_DELAY=<your GITEA_RETRY_BASE_DELAY>" -- uvx gitea-mcpReplace each placeholder with your own value before saving.
[mcp_servers.gitea-mcp]
command = "uvx"
args = ["gitea-mcp"]
[mcp_servers.gitea-mcp.env]
GITEA_URL = "<your GITEA_URL>"
GITEA_TOKEN = "<your GITEA_TOKEN>"
GITEA_TIMEOUT = "<your GITEA_TIMEOUT>"
GITEA_MAX_RETRIES = "<your GITEA_MAX_RETRIES>"
GITEA_RETRY_BASE_DELAY = "<your GITEA_RETRY_BASE_DELAY>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitea-mcp": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<your GITEA_URL>",
"GITEA_TOKEN": "<your GITEA_TOKEN>",
"GITEA_TIMEOUT": "<your GITEA_TIMEOUT>",
"GITEA_MAX_RETRIES": "<your GITEA_MAX_RETRIES>",
"GITEA_RETRY_BASE_DELAY": "<your GITEA_RETRY_BASE_DELAY>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitea-mcp": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<your GITEA_URL>",
"GITEA_TOKEN": "<your GITEA_TOKEN>",
"GITEA_TIMEOUT": "<your GITEA_TIMEOUT>",
"GITEA_MAX_RETRIES": "<your GITEA_MAX_RETRIES>",
"GITEA_RETRY_BASE_DELAY": "<your GITEA_RETRY_BASE_DELAY>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"gitea-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<your GITEA_URL>",
"GITEA_TOKEN": "<your GITEA_TOKEN>",
"GITEA_TIMEOUT": "<your GITEA_TIMEOUT>",
"GITEA_MAX_RETRIES": "<your GITEA_MAX_RETRIES>",
"GITEA_RETRY_BASE_DELAY": "<your GITEA_RETRY_BASE_DELAY>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitea-mcp": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<your GITEA_URL>",
"GITEA_TOKEN": "<your GITEA_TOKEN>",
"GITEA_TIMEOUT": "<your GITEA_TIMEOUT>",
"GITEA_MAX_RETRIES": "<your GITEA_MAX_RETRIES>",
"GITEA_RETRY_BASE_DELAY": "<your GITEA_RETRY_BASE_DELAY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"gitea-mcp": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<your GITEA_URL>",
"GITEA_TOKEN": "<your GITEA_TOKEN>",
"GITEA_TIMEOUT": "<your GITEA_TIMEOUT>",
"GITEA_MAX_RETRIES": "<your GITEA_MAX_RETRIES>",
"GITEA_RETRY_BASE_DELAY": "<your GITEA_RETRY_BASE_DELAY>"
}
}
}
}Replace each placeholder with your own value before saving.
After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.
When to choose another server
No task-specific alternatives are catalogued for gitea-mcpyet; the list above is its publisher's other servers.
What changed, and when this was checked
- First listed
- May 29, 2026
- Latest version published
- May 29, 2026
- Version history
- 1 version tracked (below)
- Requirements evidence
- Declared by Glama, last synced Nov 3, 2026. Not independently verified by MCP Toplist.
- Profile checked
- Not yet — purpose, capabilities and requirements above come from registry data only
- Ranking data as of
- Nov 3, 2026
- Glama ↗listed since May 31, 2026 · still listed
- PulseMCP ↗listed since Jun 4, 2026 · still listed
- Official MCP ↗listed since Jul 24, 2026 · still listed
Do you maintain gitea-mcp? to correct or enrich this profile.
Available versions (1)
| Version | Published |
|---|---|
| 0.5.1 | May 29, 2026 |
Ranks ahead of 108,892 of 167,945 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.werebear73%2Fgitea-mcp)<a href="https://mcptoplist.com/server/io.github.werebear73%2Fgitea-mcp"><img src="https://mcptoplist.com/badge/io.github.werebear73%2Fgitea-mcp.svg" alt="MCP Toplist: Top 50% of 167,945" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Frequently asked questions
- Who maintains gitea-mcp?
- gitea-mcp is maintained by werebear73, which publishes 2 MCP servers (2 total versions) tracked on MCP Toplist.
- Is gitea-mcp listed on the Official MCP Registry?
- Yes — gitea-mcp is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does gitea-mcp have?
- MCP Toplist tracks 1 version of gitea-mcp, most recently published on May 29, 2026.
- Where can I find the source code for gitea-mcp?
- The source code for gitea-mcp is hosted at github.com/werebear73/gitea-mcp.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.