MokoGitea MCP Server

A comprehensive Model Context Protocol server for Gitea and MokoGitea. 120+ tools for repos, issues, PRs, projects, releases, custom fields, statuses, priorities, and manifests.

Works with any Gitea instance. MokoGitea-specific features degrade gracefully on vanilla Gitea.

Quick Start

npx (no install)

GITEA_URL=https://gitea.example.com GITEA_TOKEN=your_token npx @mokoconsulting/mokogitea-mcp

Claude Code

Add to .claude.json:

{
  "mcpServers": {
    "mokogitea": {
      "command": "npx",
      "args": ["@mokoconsulting/mokogitea-mcp"],
      "env": {
        "GITEA_URL": "https://gitea.example.com",
        "GITEA_TOKEN": "your_token"
      }
    }
  }
}

Docker (SSE mode)

docker run -p 3100:3100 \
  -e GITEA_URL=https://gitea.example.com \
  -e GITEA_TOKEN=your_token \
  mokoconsulting/mokogitea-mcp

Connect MCP client to http://localhost:3100/sse.

Multi-instance config

Create ~/.mcp_mokogitea.json:

{
  "defaultConnection": "production",
  "connections": {
    "production": { "baseUrl": "https://gitea.example.com", "token": "your_token" },
    "dev": { "baseUrl": "https://dev.gitea.example.com", "token": "dev_token" }
  }
}

Configuration

| Method | Use Case | |--------|----------| | GITEA_URL + GITEA_TOKEN env vars | Single instance, quick setup | | ~/.mcp_mokogitea.json config file | Multiple instances | | GITEA_API_MCP_CONFIG env var | Custom config path | | GITEA_INSECURE=true | Skip TLS verification |

Tools (120+)

Repositories

gitea_repo_create gitea_repo_get gitea_repo_edit gitea_repo_delete gitea_repo_search gitea_repo_fork gitea_repo_generate gitea_repo_languages gitea_repo_contributors gitea_repo_topics gitea_repo_topics_set

Issues

gitea_issue_create (dedup by title) gitea_issue_get gitea_issue_update gitea_issues_list gitea_issue_search gitea_issue_comment_create gitea_issue_comments_list gitea_issue_labels_set gitea_issue_bulk_set_status

Pull Requests

gitea_pull_create gitea_pull_get gitea_pulls_list gitea_pull_merge gitea_pull_files gitea_pull_review_create

Branches and Tags

gitea_branches_list gitea_branch_create gitea_branch_delete gitea_branch_get gitea_tags_list gitea_tag_create gitea_tag_delete

Releases

gitea_releases_list gitea_release_create gitea_release_get gitea_release_latest gitea_release_delete gitea_release_asset_upload gitea_release_asset_delete

Files and Trees

gitea_file_get gitea_file_create_or_update gitea_file_delete gitea_dir_get gitea_tree_get gitea_bulk_file_push

Projects

gitea_project_list gitea_project_create gitea_project_get gitea_project_update gitea_project_delete gitea_project_overview gitea_project_columns_list gitea_project_column_create gitea_project_column_delete gitea_project_cards_list gitea_project_card_add gitea_project_card_move gitea_project_card_remove

Organizations

gitea_org_get gitea_org_repos gitea_org_members_list gitea_org_teams_list gitea_org_labels_list gitea_org_label_create

Wiki

gitea_wiki_pages_list gitea_wiki_page_get

MokoGitea Extensions

gitea_manifest_get gitea_manifest_update gitea_org_custom_fields_list gitea_org_custom_field_create gitea_org_custom_field_delete gitea_issue_custom_fields_get gitea_issue_custom_fields_set gitea_org_issue_statuses_list gitea_issue_set_status gitea_org_issue_priorities_list gitea_issue_set_priority

Admin and Other

gitea_me gitea_users_search gitea_user_get gitea_notifications_list gitea_notifications_read gitea_commits_list gitea_commit_get gitea_compare gitea_webhooks_list gitea_webhook_create gitea_admin_users_list gitea_admin_orgs_list gitea_admin_cron_list gitea_admin_cron_run gitea_list_connections

SSE Server

For hosted deployments:

GET  /         Server info
GET  /sse      SSE connection endpoint
POST /message  Tool call messages
GET  /health   Health check

License

GPL-3.0-or-later - Moko Consulting