Redmine MCP Plugin

A Redmine plugin that exposes Redmine as a Model Context Protocol (MCP) server with OAuth 2.1 authentication, enabling Claude AI and other MCP clients to access Redmine data.

Features

• MCP Server — Streamable HTTP transport at /mcp with 10 tools
• OAuth 2.1 + PKCE — Authorization Code flow with S256 code challenge
• Dynamic Client Registration — RFC 7591 compliant at /mcp/oauth/register
• SSO-compatible consent page — Uses existing Redmine session, no password re-entry
• Admin panel — View, filter, and revoke OAuth authorizations at /admin/mcp/tokens
• Trusted URI whitelist — Admin-controlled redirect URI allowlist

MCP Tools

Installation

1. Clone this plugin into Redmine's plugins/ directory:

   git clone https://github.com/your-org/redmine_mcp plugins/redmine_mcp
   

2. Run migrations:

   bundle exec rake redmine:plugins:migrate RAILS_ENV=production
   

3. Restart Redmine.

Usage with Claude AI

1. In Claude, add a new MCP connector with URL https://your-redmine-host/mcp
2. Claude will initiate the OAuth flow and open your browser
3. Log in to Redmine and click Authorize
4. Claude now has access to your Redmine data

Admin Configuration

Navigate to Administration → MCP Authorizations to:

• View all active OAuth tokens
• Filter by user, client name, or status
• Revoke individual tokens or all tokens for a user
• Manage trusted redirect URI whitelist

Development

Setup (Dev Container)

Open in VS Code with the Dev Containers extension. The container will:

• Install Redmine 5.1, 6.0, and 6.1
• Symlink this plugin into each version
• Set up test databases

Run Unit/Functional/Integration Tests

RAILS_ENV=test bundle exec rake redmine:plugins:test NAME=redmine_mcp

Run E2E Tests

npx playwright test --reporter list --workers 1

Lint

npm run lint        # TypeScript

Compatibility

License

GPL-2.0