Forgejo MCP, developed by Raohwork, is an MCP server designed to bridge Git forge services with AI assistants. Built primarily with Go, this free tool enables AI models to interact directly with code repositories hosted on Forgejo and Gitea instances. It functions as an integration plugin, allowing developers and operations teams to incorporate AI capabilities into their existing version control workflows. Forgejo MCP extends the utility of these platforms by exposing repository management and project tracking functions to AI clients.

What does Forgejo MCP connect to?

Forgejo MCP serves as an integration point, connecting directly to Forgejo and Gitea instances. Its core purpose is to bridge these Git forge services with various AI assistants, enabling AI models to interact with code repositories. This MCP server supports stdio for local integration, SSE for event streaming, and HTTP for remote access. Confirmed compatible AI clients include Claude, Gemini, Copilot, Cursor, and VS Code extensions, allowing for diverse AI-driven interactions with repository data.

Core features and tools

The program exposes a set of callable tools for managing repositories and issues. These include get_my_user_info, create_repo, fork_repo, list_my_repos, create_issue, add_issue_comment, list_repo_issues, list_repo_pull_requests, create_pull_request, search_users, search_org_teams, search_repos, and get_forgejo_mcp_server_version. Additionally, it provides delete_repo_hook and test_repo_hook. The tool also supports capabilities like listing repository commits and getting file content, implying further callable interactions.

Who is it for?

Forgejo MCP is intended for developers and operations teams who utilize Forgejo or Gitea and seek to integrate AI assistants into their repository management and DevOps workflows. It addresses the need for AI models to directly interact with code repositories, enhancing productivity and automation. This tool is valuable for those aiming to automate tasks, assist with code reviews, or manage project issues using AI. Skip this if your organization does not use Forgejo or Gitea, or if you do not require AI integration with your code repositories.

How to get started

The server authenticates using a token-based model. This token can be provided to Forgejo MCP via command-line arguments or environment variables for single-user operation, or through an "Authorization: Bearer <token>" or "Authorization: token <token>" header for multi-user HTTP mode.

Use cases

• AI-powered repository management, such as creating new repositories, forking existing ones, listing repositories, and managing branches through chat commands.
• Automated issue tracking and project management, including categorizing issues, applying labels, setting milestones, prioritizing tasks based on content analysis, and adding comments via AI.
• AI-assisted code reviews and documentation, where AI can access pull requests to summarize changes and provide suggestions, and organize wiki documentation.

Forgejo MCP provides a direct bridge for AI assistants to interact with Forgejo and Gitea instances, enabling advanced automation for development and operations teams. Its token-based authentication and support for various transport protocols make it adaptable for different deployment scenarios. The tool empowers AI models to manage repositories, track issues, and assist with code reviews, enhancing workflow efficiency.