A MCP Server for Gitea so that AI and other tools can access Gitea directly.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add gitea --env GITEA_URL='<GITEA_URL>' --env GITEA_TOKEN='<GITEA_TOKEN>' -- uvx gitea-mcp~/.codex/config.toml
[mcp_servers.gitea]
command = "uvx"
args = ["gitea-mcp"]
env = { GITEA_URL = "<GITEA_URL>", GITEA_TOKEN = "<GITEA_TOKEN>" }
# codex mcp add gitea --env GITEA_URL='<GITEA_URL>' --env GITEA_TOKEN='<GITEA_TOKEN>' -- uvx gitea-mcp~/.cursor/mcp.json
{
"mcpServers": {
"gitea": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<GITEA_URL>",
"GITEA_TOKEN": "<GITEA_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"gitea": {
"type": "stdio",
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<GITEA_URL>",
"GITEA_TOKEN": "<GITEA_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"gitea": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<GITEA_URL>",
"GITEA_TOKEN": "<GITEA_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"gitea": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<GITEA_URL>",
"GITEA_TOKEN": "<GITEA_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"gitea": {
"command": "uvx",
"args": [
"gitea-mcp"
],
"env": {
"GITEA_URL": "<GITEA_URL>",
"GITEA_TOKEN": "<GITEA_TOKEN>"
}
}
}
}Environment variables
GITEA_URLGITEA_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.