Skip to content
MCP server

Forgejo / Codeberg / Gitea

Rust MCP server for Forgejo, Codeberg and Gitea: repos, issues, PRs and CI, writes opt-in

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.27.0
Listing updated
today

Similar MCP servers

About Forgejo / Codeberg / Gitea

Forgejo / Codeberg / Gitea is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

forgejo-mcp-rs talks directly to the Forgejo and Gitea REST API through its own small client, with no third-party forge SDK in the path that holds your token. It is read-only by default and covers the authenticated user, repositories, issues, pull requests, search, organisations, notifications, comments, reviews and Actions runs.

Writes are gated twice. A separate write token must be supplied, and a deliberate time-boxed write mode (10 minutes by default, 60 at most) must be switched on. The read token is mandatory and must differ from the write token. Credentials for push mirrors and repository migration come from environment variables rather than tool arguments, and release uploads are disabled until an upload directory is set.

It detects whether an instance is Forgejo or Gitea from its version string and normalises the differing Actions endpoints into one shape. It speaks MCP 2026-07-28 and falls back to 2024-11-05 over stdio, and runs on macOS and Linux with Windows untested. The default instance is codeberg.org.

Install

Run in a terminal

claude mcp add forgejo-mcp-rs -- npx -y forgejo-mcp-rs

Add to claude_desktop_config.json

{
  "mcpServers": {
    "forgejo-mcp-rs": {
      "command": "npx",
      "args": [
        "-y",
        "forgejo-mcp-rs"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "forgejo-mcp-rs": {
      "command": "npx",
      "args": [
        "-y",
        "forgejo-mcp-rs"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "forgejo-mcp-rs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "forgejo-mcp-rs"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "forgejo-mcp-rs": {
      "command": "npx",
      "args": [
        "-y",
        "forgejo-mcp-rs"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "forgejo-mcp-rs": {
      "command": "npx",
      "args": [
        "-y",
        "forgejo-mcp-rs"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

create_repo
Creates a repository; write mode only.
edit_repo
Edits a repository; write mode only.
create_branch
Creates a branch; write mode only.
delete_branch
Deletes a branch; write mode only.
create_issue
Creates an issue; write mode only.
edit_issue
Edits an issue; write mode only.
comment_on_issue
Comments on an issue; write mode only.
create_pull_request
Opens a pull request; write mode only.
create_pull_request_review
Submits a pull request review; write mode only.
merge_pull_request
Merges a pull request; write mode only.
create_or_update_file
Creates or updates a file; write mode only.
delete_file
Deletes a file; write mode only.
delete_repo
Deletes a repository; write mode only.
migrate_repo
Migrates a repository from a source instance; write mode only.
dispatch_workflow
Dispatches a workflow; write mode only.
cancel_workflow_run
Cancels a workflow run; write mode only.
rerun_workflow
Reruns a workflow; write mode only.

What it does

Read-only by default
Reads users, repos, issues, PRs, reviews, search and CI runs.
Guarded writes
Writes need a separate token and a time-boxed write mode.
Forgejo and Gitea
Detects the flavour and normalises Actions differences.
Own API client
Uses an in-house client with no third-party forge SDK.
CI control
Dispatches, cancels and reruns workflow runs when writes are on.
Secrets kept out of chat
Mirror and migration credentials come from environment variables.

Good for

  • Summarise open issues and pull requests on Codeberg
  • Review a pull request diff and leave a review
  • Check why a CI run failed
  • Create a branch and open a PR from an agent

Pricing

Open source

Forgejo / Codeberg / Gitea FAQ

Is it read-only?

By default yes; writes need a separate token plus an active write mode.

How long does write mode last?

10 minutes by default and up to 60.

Which servers work?

Forgejo, Codeberg and Gitea.

Does it support Windows?

Windows is untested; macOS and Linux are supported.

Is Forgejo / Codeberg / Gitea free?

Yes. Forgejo / Codeberg / Gitea is open source, so you can use and self-host it for free.

How do I add Forgejo / Codeberg / Gitea to Claude Code?

Run this command in your terminal: claude mcp add forgejo-mcp-rs -- npx -y forgejo-mcp-rs

What are the best alternatives to Forgejo / Codeberg / Gitea?

The closest alternatives to Forgejo / Codeberg / Gitea are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers