redmine-mcp

@thelabnyc/redmine-mcp

An MCP (Model Context Protocol) server that allows AI agents like Claude to interact with Redmine project management data.

Features

• Create issues with full field support including fixed versions, categories, and custom fields
• Fetch issue details by ID, including subject, description, status, priority, and assignee
• Update issues: change status, assign users, add notes, set custom fields, and more
• Log time spent on issues with integrated time tracking
• List issues with general Redmine filters, saved queries, and optional includes
• List issues assigned to the current user, with filtering and sorting
• Search Redmine globally across issues, projects, wiki pages, attachments, and other content
• List projects accessible to the current user
• List saved queries visible to the current user
• List project members to find user IDs for assignments
• Manage attachments: fetch metadata, attach local files, download content, update descriptions, and delete files
• Manage issue relations: list, fetch, create, and delete Redmine relation records
• Discover metadata: list available statuses, trackers, priorities, versions, categories, and custom fields
• Retrieve change history (journals) with every request
• Optionally include attachments, watchers, relations, and child issues

Installation

npm install @thelabnyc/redmine-mcp

Or clone and build from source:

git clone https://gitlab.com/thelabnyc/redmine-mcp.git
cd redmine-mcp
npm install
npm run build

Configuration

The server requires two environment variables:

Variable	Description	Example
REDMINE_URL	Base URL of your Redmine instance	https://mycompany.plan.io
REDMINE_API_KEY	Your Redmine API key	abc123def456...
REDMINE_MCP_FILE_ROOT	Directory that attachment upload paths must stay within; OS temp files are also allowed	/Users/me/redmine-files
REDMINE_MCP_MAX_UPLOAD_BYTES	Maximum local file size allowed for attach-file-to-issue in bytes	104857600

Getting your Redmine API Key

1. Log into your Redmine instance
2. Go to My Account (click your name in the top right)
3. In the right sidebar, find API access key
4. Click Show to reveal your key, or Reset to generate a new one

Usage with Claude Code

Add the server to your Claude Code configuration:

Project-level configuration

Create or edit .claude/settings.json in your project:

{
    "mcpServers": {
        "redmine": {
            "command": "npx",
            "args": ["@thelabnyc/redmine-mcp"],
            "env": {
                "REDMINE_URL": "https://your-instance.plan.io",
                "REDMINE_API_KEY": "your-api-key-here"
            }
        }
    }
}

User-level configuration

Add to ~/.claude.json to make available across all projects:

{
    "mcpServers": {
        "redmine": {
            "command": "npx",
            "args": ["@thelabnyc/redmine-mcp"],
            "env": {
                "REDMINE_URL": "https://your-instance.plan.io",
                "REDMINE_API_KEY": "your-api-key-here"
            }
        }
    }
}

Using a local build

If you've cloned the repository:

{
    "mcpServers": {
        "redmine": {
            "command": "node",
            "args": ["/path/to/redmine-mcp/dist/cli.js"],
            "env": {
                "REDMINE_URL": "https://your-instance.plan.io",
                "REDMINE_API_KEY": "your-api-key-here"
            }
        }
    }
}

Available Tools

get-issue

Fetch details about a Redmine issue by ID.

Parameters:

Parameter	Type	Required	Description
issueId	string	Yes	Issue ID (e.g., #12345 or 12345)
includeAttachments	boolean	No	Include file attachments
includeWatchers	boolean	No	Include watchers list
includeRelations	boolean	No	Include related issues
includeChildren	boolean	No	Include child issues

Note: Change history (journals) is always included by default.

Example usage in Claude:

"Look up Redmine issue #12345 and summarize the recent activity"

get-attachment