MCP Redmine

@runekaagaard

About MCP Redmine

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

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.

Can I change the API response format?

Yes, set REDMINE_RESPONSE_FORMAT to yaml (default) or json to control how API responses are formatted.

What if my Redmine uses a self-signed SSL certificate?

Set REDMINE_DANGEROUSLY_ACCEPT_INVALID_CERTS to 1 to disable SSL certificate verification. Only use this in trusted environments.

Frequently asked questions

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.

Can I change the API response format?

Yes, set `REDMINE_RESPONSE_FORMAT` to `yaml` (default) or `json` to control how API responses are formatted.

What if my Redmine uses a self-signed SSL certificate?

Set `REDMINE_DANGEROUSLY_ACCEPT_INVALID_CERTS` to `1` to disable SSL certificate verification. Only use this in trusted environments.

Comments

Basic information

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep