gitea-mcp

Name: gitea-mcp
Author: werebear73

Community

MCP server by werebear73 · updated 4 months ago · ★ 2

Score 38

Model Context Protocol server for Gitea (and Forgejo, Codeberg). gitea-mcp is a community project by werebear73, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Install gitea-mcp

Built from the published package, never by AI

claude mcp add gitea-mcp -e GITEA_URL=YOUR_GITEA_URL -e GITEA_TOKEN=YOUR_GITEA_TOKEN -- uvx gitea-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install gitea-mcp in Claude Code

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "uvx",
      "args": [
        "gitea-mcp"
      ],
      "env": {
        "GITEA_URL": "YOUR_GITEA_URL",
        "GITEA_TOKEN": "YOUR_GITEA_TOKEN"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install gitea-mcp in Claude Desktop

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "uvx",
      "args": [
        "gitea-mcp"
      ],
      "env": {
        "GITEA_URL": "YOUR_GITEA_URL",
        "GITEA_TOKEN": "YOUR_GITEA_TOKEN"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install gitea-mcp in Cursor

{
  "servers": {
    "gitea-mcp": {
      "command": "uvx",
      "args": [
        "gitea-mcp"
      ],
      "env": {
        "GITEA_URL": "YOUR_GITEA_URL",
        "GITEA_TOKEN": "YOUR_GITEA_TOKEN"
      }
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install gitea-mcp in VS Code

codex mcp add gitea-mcp --env GITEA_URL=YOUR_GITEA_URL --env GITEA_TOKEN=YOUR_GITEA_TOKEN -- uvx gitea-mcp

Step-by-step: install gitea-mcp in Codex

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "uvx",
      "args": [
        "gitea-mcp"
      ],
      "env": {
        "GITEA_URL": "YOUR_GITEA_URL",
        "GITEA_TOKEN": "YOUR_GITEA_TOKEN"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install gitea-mcp in Antigravity CLI

gemini mcp add gitea-mcp uvx gitea-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install gitea-mcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the gitea-mcp block.

Maintenance

Last commit 147 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`GITEA_URL`Environment variable	Required	Base URL of your Gitea/Forgejo/Codeberg instance
`GITEA_TOKEN`Environment variable, secret	Required	Personal access token for the configured instance
`GITEA_TIMEOUT`Environment variable	Optional	HTTP request timeout in seconds Default: `30`
`GITEA_MAX_RETRIES`Environment variable	Optional	Retry count for transient failures Default: `3`
`GITEA_RETRY_BASE_DELAY`Environment variable	Optional	Retry backoff base delay in seconds Default: `0.5`

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Weekly newsletter

Like gitea-mcp? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to gitea-mcp

All alternatives →

Codebase MemoryDeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

AAA Local 47k

ha-mcphomeassistant-ai

Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.

AAA Local 5.1k

Agentic Flow ruvnet

The agentic meta-harness — freeze the model, evolve the harness. An open runtime that routes each query to the cost-optimal model, evolves its own harness (planner/context/reviewer/retry/tool/memory/score policy) and autonomously repairs code, then orches

AAA Local 62k/wk

Pi MCP earendil-works

Standalone Model Context Protocol client for pi and other applications

AAA Local 1.4M/wk

Pi MCP Adapter nicobailon

MCP (Model Context Protocol) adapter extension for Pi coding agent

AAA Local 206k/wk

Posthog MCP PostHog

PostHog SDK for Model Context Protocol (MCP) servers — tracks tool usage, intent, and identity

AAA Local 247k/wk

gitea-mcp vs Codebase Memory gitea-mcp vs ha-mcp gitea-mcp vs Agentic Flow

gitea-mcp: common questions

How do I install gitea-mcp?

In Claude Code run claude mcp add gitea-mcp -e GITEA_URL=YOUR_GITEA_URL -e GITEA_TOKEN=YOUR_GITEA_TOKEN -- uvx gitea-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is gitea-mcp the official server?

gitea-mcp is a community project by werebear73, not verified by a company domain.

Is gitea-mcp free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is gitea-mcp safe to use?

It scores 38 of 100. Grades: maintenance C, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to gitea-mcp?

Similar MCP servers: Codebase Memory, ha-mcp, Agentic Flow, Pi MCP.

Does gitea-mcp work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.