MCP Redmine

Name: MCP Redmine
Author: runekaagaard

@runekaagaard

Repository

About MCP Redmine

A redmine MCP server covering close to 100% of redmines API

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-redmine": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-redmine",
        "."
      ]
    }
  }
}

Tools

Return a list of available API paths from OpenAPI spec

Get full path information for given path templates

Make a request to the Redmine API

Upload a file to Redmine and get a token for attachment

Download an attachment from Redmine and save it to a local file

Overview

What is MCP Redmine?

MCP Redmine is an MCP server that connects Claude Desktop to a Redmine instance, allowing Claude to search and browse projects and issues, create and update issues with markdown support, upload and download file attachments, manage time entries, update issue statuses, and access comprehensive Redmine API functionality.

How to use MCP Redmine?

Install via uvx or Docker. Add a redmine entry to your claude_desktop_config.json, providing REDMINE_URL and REDMINE_API_KEY environment variables. Optionally configure REDMINE_REQUEST_INSTRUCTIONS, REDMINE_ALLOWED_DIRECTORIES, and other settings. Run the server and invoke its five tools: redmine_paths_list, redmine_paths_info, redmine_request, redmine_upload, and redmine_download.

Key features of MCP Redmine

Connects Claude Desktop to any Redmine instance
Search, create, and update issues with markdown
Upload and download file attachments
Manage and track time entries
Full Redmine API coverage via dynamic tools
Uses httpx and Redmine OpenAPI specification

Use cases of MCP Redmine

Create and assign bug reports with detailed descriptions
Search for unassigned high-priority issues across projects
Update issue statuses and add comments from Claude
Log time entries against specific issues
Upload screenshots or download attachments from Redmine

FAQ from MCP Redmine

How do I get my Redmine API key?

Log in to Redmine, go to "My account", find "API access key" on the right side, then click "Show" or "Generate" to obtain the key.

What environment variables are required?

REDMINE_URL (your Redmine instance URL) and REDMINE_API_KEY are required. REDMINE_ALLOWED_DIRECTORIES is required for file upload/download operations.

Why are file uploads/downloads not working?

File operations require REDMINE_ALLOWED_DIRECTORIES to be set to a comma-separated list of directories where files may be read or written. This protects against path traversal attacks.