How do I use forgejo-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@forgejo-mcp show my recent notifications" 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.

forgejo-mcp

by openmanbo

Overview Schema Source Related Servers Discussions Admin

TypeScript

forgejo-mcp

A Model Context Protocol (MCP) server for Forgejo that enables AI agents to interact with a Forgejo instance as an authenticated user.

Features

Tool	Forgejo API endpoint	Description
`search_issues`	`GET /api/v1/repos/issues/search`	Search issues & PRs across all repos
`list_issues`	`GET /api/v1/repos/{owner}/{repo}/issues`	List issues in a repository
`get_issue`	`GET /api/v1/repos/{owner}/{repo}/issues/{index}`	Get a single issue
`create_issue`	`POST /api/v1/repos/{owner}/{repo}/issues`	Create a new issue
`edit_issue`	`PATCH /api/v1/repos/{owner}/{repo}/issues/{index}`	Edit an issue
`list_issue_comments`	`GET /api/v1/repos/{owner}/{repo}/issues/{index}/comments`	List comments
`create_comment`	`POST /api/v1/repos/{owner}/{repo}/issues/{index}/comments`	Add a comment
`search_repos`	`GET /api/v1/repos/search`	Search repositories
`get_repo`	`GET /api/v1/repos/{owner}/{repo}`	Get repository info
`get_user`	`GET /api/v1/user`	Get authenticated user profile
`get_user_info`	`GET /api/v1/users/{username}`	Get any user's public profile
`list_notifications`	`GET /api/v1/notifications`	List notifications
`list_pull_requests`	`GET /api/v1/repos/{owner}/{repo}/pulls`	List pull requests in a repository
`get_pull_request`	`GET /api/v1/repos/{owner}/{repo}/pulls/{index}`	Get a single pull request
`create_pull_request`	`POST /api/v1/repos/{owner}/{repo}/pulls`	Create a new pull request
`edit_pull_request`	`PATCH /api/v1/repos/{owner}/{repo}/pulls/{index}`	Edit a pull request
`merge_pull_request`	`POST /api/v1/repos/{owner}/{repo}/pulls/{index}/merge`	Merge a pull request
`get_pull_request_diff`	`GET /api/v1/repos/{owner}/{repo}/pulls/{index}.diff`	Get PR diff as plain text
`get_pull_request_files`	`GET /api/v1/repos/{owner}/{repo}/pulls/{index}/files`	List files changed in a PR
`list_pull_request_reviews`	`GET /api/v1/repos/{owner}/{repo}/pulls/{index}/reviews`	List reviews on a PR
`update_pull_request_branch`	`POST /api/v1/repos/{owner}/{repo}/pulls/{index}/update`	Update a PR branch

Related MCP server: GitHub MCP Server

Requirements

Node.js ≥ 18
A Forgejo personal access token

Installation

npm install -g @openmanbo/forgejo-mcp

Setup

Generate a Forgejo token:
Go to <your-forgejo-instance>/user/settings/applications and create a token with the scopes you need (at minimum read:issue for searching).

Configure environment variables:

export FORGEJO_URL=https://codeberg.org   # or your own instance
export FORGEJO_TOKEN=your_token_here

Running the server

forgejo-mcp
# or with npx (no install needed):
npx @openmanbo/forgejo-mcp

The server communicates over stdio using the MCP protocol.

Connecting to an MCP client

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "forgejo": {
      "command": "npx",
      "args": ["-y", "@openmanbo/forgejo-mcp"],
      "env": {
        "FORGEJO_URL": "https://codeberg.org",
        "FORGEJO_TOKEN": "your_token_here"
      }
    }
  }
}

VS Code (`.vscode/mcp.json`)

{
  "servers": {
    "forgejo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@openmanbo/forgejo-mcp"],
      "env": {
        "FORGEJO_URL": "https://codeberg.org",
        "FORGEJO_TOKEN": "${env:FORGEJO_TOKEN}"
      }
    }
  }
}

Development

git clone https://github.com/openmanbo/forgejo-mcp.git
cd forgejo-mcp
npm install
npm run build
npm test        # run unit tests

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

Need Help?

Related Servers

Related MCP Connectors

KukGitOAuth
io.github.amithkukllod777
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
Version Control Project Management Developer Tools
1
smithery-ai-github
ai.smithery
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Version Control Developer Tools CI/CD & DevOps
295
GitHubOAuth
io.github.github
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Version Control Developer Tools CI/CD & DevOps
1232,954
OrbitOAuth
io.github.Noveum
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Project Management Workplace & Productivity
130

Related MCP Servers

GitHub Integration Hub
Version Control Developer Tools App Automation
CrBatista
F
license
Not graded
quality
D
maintenance
Enables AI agents to interact with GitHub through OAuth-authenticated operations including starting authorization flows, listing repositories, and creating issues using stored access tokens.
Updated 10 months ago (2025-11-19 16:46 UTC)
1
-
GitHub MCP Server
Version Control Developer Tools
vinkius-labs
F
license
Not graded
quality
D
maintenance
Enables AI agents to interact with GitHub repositories, issues, pull requests, code, and more through a comprehensive set of tools.
Updated 3 months ago (2026-06-20 05:40 UTC)
-
@maxronner/tea-mcp
Version Control Developer Tools
maxronner
A
license
A
quality
D
maintenance
Enables AI assistants to manage Gitea repositories, issues, and pull requests via the tea CLI, including full PR review workflows.
Updated 5 months ago (2026-04-15 11:13 UTC)
15
6 npm
MIT
mcp-github_private
Version Control Developer Tools
pipeworx-io
A
license
Not graded
quality
C
maintenance
Enables AI agents to access private GitHub repositories, organizations, issues, pull requests, and file contents via OAuth authentication.
Updated 3 days ago (2026-09-13 06:33 UTC)
1 npm
MIT

forgejo-mcp

Features

Requirements

Installation

Setup

Running the server

Connecting to an MCP client

Claude Desktop (claude_desktop_config.json)

VS Code (.vscode/mcp.json)

Development

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

GitHub Integration Hub

GitHub MCP Server

@maxronner/tea-mcp

mcp-github_private

Claude Desktop (`claude_desktop_config.json`)

VS Code (`.vscode/mcp.json`)