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: |
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
adminscope: admin-only calls need theX-Redmine-API-Keyheader. - 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.
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.