PluginBench
MCP Server

gitea-mcp MCP Server

io.github.werebear73/gitea-mcp

RepositoryRegistry

What is the gitea-mcp MCP server?

Model Context Protocol server for Gitea (and Forgejo, Codeberg).

How to install gitea-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • GITEA_URL
    required

    Base URL of your Gitea/Forgejo/Codeberg instance

  • GITEA_TOKEN
    required
    secret

    Personal access token for the configured instance

  • GITEA_TIMEOUT

    HTTP request timeout in seconds

  • GITEA_MAX_RETRIES

    Retry count for transient failures

  • GITEA_RETRY_BASE_DELAY

    Retry backoff base delay in seconds

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "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>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "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>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "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>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "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>"
      }
    }
  }
}
Claude Code
claude mcp add gitea-mcp --env GITEA_URL=<YOUR_GITEA_URL> --env GITEA_TOKEN=<YOUR_GITEA_TOKEN> --env GITEA_TIMEOUT=<YOUR_GITEA_TIMEOUT> --env GITEA_MAX_RETRIES=<YOUR_GITEA_MAX_RETRIES> --env GITEA_RETRY_BASE_DELAY=<YOUR_GITEA_RETRY_BASE_DELAY> -- uvx gitea-mcp

Related MCP servers

io.github.werebear73/sipnav-mcp

MCP server for the SIPNAV VOIP switch.

View repository →