• Minimum Version: v1.26.1-moko.1
  • Applicable Software: MCP Server
  • Applicable Version: v1.0.0

What It Does

gitea-api-mcp is a Model Context Protocol (MCP) server that bridges AI assistants like Claude Code with the Gitea REST API v1. It supports multiple named connections, so you can manage several Gitea instances from a single server.

Tool Categories (61 tools)

  • Repositories (8) — get, create, delete, edit, fork, search, list org repos
  • File Contents (5) — get/create/update/delete files, directory listings, git tree
  • Branches (4) — list, get, create, delete
  • Commits (2) — list, get
  • Issues (7) — list, get, create, update, comments, search
  • Labels & Milestones (4) — list, create
  • Pull Requests (6) — list, get, create, merge, files, review
  • Releases (5) — list, get, latest, create, delete
  • Tags (3) — list, create, delete
  • Actions (2) — list workflow runs, get run details
  • Organizations (3) — get org, list teams, list members
  • Users (5) — me, get user, search, list orgs, list repos
  • Webhooks (2) — list, create
  • Wiki (2) — list pages, get page
  • Notifications (2) — list, mark as read
  • Generic (1) — raw API request for any endpoint

Quick Start

git clone https://git.mokoconsulting.tech/MokoConsulting/gitea-api-mcp.git
cd gitea-api-mcp
npm install
npm run build

Configuration

Create ~/.gitea-api-mcp.json:

{
  "defaultConnection": "moko",
  "connections": {
    "moko": {
      "baseUrl": "https://git.mokoconsulting.tech",
      "token": "your-gitea-access-token"
    }
  }
}

Claude Code Registration

Add to your MCP config (~/.claude.json or project .mcp.json):

{
  "mcpServers": {
    "gitea-api": {
      "command": "node",
      "args": ["/path/to/gitea-api-mcp/dist/index.js"]
    }
  }
}

Source & License

Open source under GPL-3.0-or-later. Repository: MokoConsulting/gitea-api-mcp