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

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K