Gitea MCP Server

Generate an MCP client configuration for Claude Desktop, Cursor, or any MCP-compatible client.

Template Config

{
  "mcpServers": {
    "gitea": {
      "command": "uvx",
      "args": ["--refresh", "--extra-index-url", "https://nikitatsym.github.io/gitea-mcp/simple", "gitea-mcp"],
      "env": {
        "GITEA_URL": "YOUR_GITEA_URL",
        "GITEA_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Generate Your Config

Base URL of your Gitea instance (no trailing slash).

Personal access token from Gitea → Settings → Applications.

How to Create a Gitea API Token

  1. Log in to your Gitea instance.
  2. Go to Settings → Applications.
  3. Under Manage Access Tokens, enter a token name (e.g. mcp-server).
  4. Select the permissions your agent needs (read/write on repos, issues, etc.).
  5. Click Generate Token and copy the value immediately — it is shown only once.
  6. Paste the token into the field above, click Generate Config, and add the result to your MCP client configuration file.

Where to Put the Config

  1. Claude Desktop — paste into claude_desktop_config.json.
  2. Cursor — paste into .cursor/mcp.json in your project root.
  3. Claude Code — paste into .claude/settings.json or use claude mcp add.
  4. For other MCP clients, consult their documentation on where to place the server configuration.