Provides comprehensive access to the Gitea API, allowing AI agents to manage repositories, issues, pull requests, releases, branches, file contents, organizations, teams, and CI/CD workflows.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gitea-mcplist all open pull requests in the web-app repository"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gitea-mcp
MCP server for Gitea -- full API coverage for autonomous AI agents.
Features
186 tools covering the entire Gitea API surface
Repositories, issues, pull requests, releases, labels, milestones
File content management (create, read, update, delete)
Branches, tags, commits, and status checks
Actions / CI workflows and artifacts
Organizations, teams, and user management
Webhooks, deploy keys, notifications, wiki, packages
Admin endpoints for instance-level operations
Zero-config install via
uvx
Quick Start
Add the following to your MCP client configuration (Claude Desktop, Cursor, Claude Code, etc.):
Or use the interactive Setup Page to generate the config.
Configuration
Variable | Required | Description |
| Yes | Base URL of your Gitea instance (e.g. |
| Yes | Personal access token with appropriate permissions |
Creating a Gitea API Token
Log in to your Gitea instance.
Go to Settings > Applications.
Under Manage Access Tokens, enter a token name (e.g.
mcp-server).Select the permissions your agent needs (read/write on repos, issues, etc.).
Click Generate Token and copy the value immediately -- it is shown only once.
Running Tests
The test suite runs against a real Gitea instance managed by Docker Compose.