Forgejo MCP Server

What it does

Connects an MCP-compatible AI assistant to a Forgejo instance (e.g., Codeberg.org), allowing the agent to perform repository management tasks through natural language commands.

Tools

• list_my_repos: List all repositories owned by the user.
• create_repo: Create a new repository.
• get_file_content: Retrieve content of a specific file with optional line ranges.
• list_repo_issues: List issues in a repository.
• create_issue: Create a new issue.
• list_repo_pull_requests: List open pull requests.
• merge_pull_request: Merge a PR with various styles (merge/rebase/squash).
• dispatch_workflow: Trigger a workflow run via workflow_dispatch.
• add_issue_time: Log time against an issue or PR.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp",
      "args": [
        "--transport", "stdio",
        "--url", "https://your-forgejo-instance.org"
      ],
      "env": {
        "FORGEJO_ACCESS_TOKEN": "<your personal access token>",
        "FORGEJO_USER_AGENT": "forgejo-mcp/1.0.0"
      }
    }
  }
}

Supported hosts

Claude Desktop, Claude Code, Codex, Cursor