Project

General

Profile

Plugins Directory » MCP Redmine

Author: Gabriel Lana
Website: https://github.com/gabera/mcp_redmine
Code repository: https://github.com/gabera/mcp_redmine
Registered on: 2026-11-18 (about 6 hours ago)
Current version: 1.0.0
Compatible with: Redmine 7.1.x, 7.0.x, 6.1.x
User ratings:   (1)

An MCP (Model Context Protocol) server that runs inside Redmine, at /mcp. AI assistants (Claude, ChatGPT, GitHub Copilot, Cursor, etc.) use the whole Redmine REST API on behalf of each user, with that user's own permissions. There is no separate server to deploy.

Features

  • Connect with just the URL. Clients find Redmine's built-in OAuth2 provider (Redmine 6.1+) through the standard discovery documents and register themselves (dynamic client registration, PKCE). Users log in to Redmine and authorize the application; they can revoke it in My account.
  • Whole REST API. Calls run in-process through Redmine's own API controllers, so Redmine applies each user's roles and the OAuth scope on every call.
  • Separate read and write tools, so clients can let reads run and ask the user before every write.
  • Attachments: download (text and images come back to the assistant) and upload, using Redmine's size and extension limits.
  • Instructions for the model configured by the administrator (e.g. "use Textile", project ids, required custom fields), sent to clients without restarting Redmine.

Tools

Tool Description
redmine_request Read from the API (GET)
redmine_write Create, update or delete (POST, PUT, PATCH, DELETE)
redmine_download Get an attachment
redmine_upload Upload a file and get a token to attach it
redmine_paths_list List the API paths
redmine_paths_info Describe API paths from an OpenAPI specification

Security

  • Tokens never get the admin scope: admin-only calls need the X-Redmine-API-Key header.
  • The consent page shows the host the token is sent to, in the application name.
  • Off by default; requires the REST API to be enabled.

See the README for client setup (Claude Code, Claude Desktop, VS Code).

Installation notes

Requires Redmine 6.1 or later, with the REST API enabled (Administration > Settings > API). Redmine must be served at the root of its host.

cd /path/to/redmine/plugins
git clone https://github.com/gabera/mcp_redmine.git
# restart Redmine

The directory must be named mcp_redmine. No migrations and no extra gems.

Then enable it in Administration > Plugins > MCP Redmine > Configure and connect your MCP client to https://<your-redmine>/mcp.

Changelog

1.0.0 (2026-11-18)

Compatible with Redmine 7.1.x, 7.0.x, 6.1.x.

User ratings

  by Gabriel Lana about 6 hours ago