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

Tool	Description
list_projects	List visible projects
get_project	Get project details
list_issues	List issues with filters
get_issue	Get issue details
create_issue	Create a new issue
update_issue	Update an existing issue
list_users	List users (admin only)
search	Full-text search
list_time_entries	List time entries
create_time_entry	Log time on an issue

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

Redmine	Database
5.1, 6.0, 6.1	SQLite, MySQL 5.7+, PostgreSQL 14+

License

GPL-2.0