Forgejo MCP Server is an integration plugin designed to connect Forgejo with Model Context Protocol (MCP) systems. This allows for seamless command execution and repository management through an MCP-compatible chat interface.

You can download the source code by cloning the repository using Git:

git clone https://codeberg.org/goern/forgejo-mcp.git

Before building, make sure you have the following installed:

• make
• Golang (Go 1.24 or later recommended)

Then run:

make build

After building, copy the binary forgejo-mcp to a directory included in your system's PATH. For example:

cp forgejo-mcp /usr/local/bin/

This example is for Cursor, you can also use plugins in VSCode. To configure the MCP server for Forgejo, add the following to your MCP configuration file:

• stdio mode

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

• sse mode

{
  "mcpServers": {
    "forgejo": {
      "url": "http://localhost:8080/sse"
    }
  }
}

Once everything is set up, try typing the following in your MCP-compatible chatbox:

list all my repositories

The Forgejo MCP Server supports the following tools:

To enable debug mode, add the -d flag when running the Forgejo MCP Server with sse mode:

./forgejo-mcp --transport sse --url <forgejo-url> [--sse-port 8080] --token <your personal access token> --debug

Enjoy exploring and managing your Forgejo repositories via chat!