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