MCP Redmine works with any MCP client (Claude Code, Cursor, IntelliJ-based IDEs, n8n, etc.) - point your
client at the same command and environment variables as above, following your client's documentation for
registering MCP servers.
By default the server speaks stdio. For clients or setups that connect over HTTP, start the server with one
of the HTTP transports:
# Recommended HTTP transport (serves on http://HOST:PORT/mcp)
mcp-redmine --transport streamable-http --host 0.0.0.0 --port 8000
# Legacy SSE transport, for older clients (serves on http://HOST:PORT/sse)
mcp-redmine --transport sse --host 0.0.0.0 --port 8000
Multi-user HTTP deployments
When running as a shared HTTP server, each client can send its own Redmine API key in an
X-Redmine-API-Key request header, so actions are attributed to the calling user instead
of one shared service account. The header takes precedence; REDMINE_API_KEY remains the
fallback (and the only option on stdio). Example with Claude Code:
Only do this over trusted networks or TLS - the header carries a credential.
Environment Variables
Variable
Required
Default
Description
REDMINE_URL
Yes
-
URL of your Redmine instance. Subpaths are supported (e.g., http://localhost/redmine/)
REDMINE_API_KEY
Yes*
-
Your Redmine API key (see below for how to get it). *Optional when every client sends X-Redmine-API-Key (see Multi-user below)
REDMINE_REQUEST_INSTRUCTIONS
No
-
Path to a file containing additional instructions for the redmine_request tool. I've found it works great to have the LLM generate that file after a session. (example1example2)
REDMINE_HEADERS
No
(empty)
Custom HTTP headers to include in all requests. Format: "Header1: Value1, Header2: Value2". Useful for proxies that require additional authentication (e.g., X-Redmine-Username)
REDMINE_RESPONSE_FORMAT
No
yaml
Response format: yaml or json. Controls how API responses are formatted
REDMINE_ALLOWED_DIRECTORIES
For upload/download
(disabled)
Required for file operations. Comma-separated list of directories where upload/download are allowed (e.g., /tmp,/home/user/uploads). Upload/download are disabled if not set for security
REDMINE_DANGEROUSLY_ACCEPT_INVALID_CERTS
No
(disabled)
Set to 1 to disable SSL certificate verification. Use only for self-signed certs in trusted environments
REDMINE_CA_BUNDLE
No
(system CAs)
Path to a custom CA certificate bundle (e.g. /path/to/ca.crt) for Redmine instances using a private certificate chain. Prefer this over disabling verification
REDMINE_READ_ONLY
No
(disabled)
Set to 1 to only allow GET requests. All writing operations (POST/PUT/DELETE, including uploads) are refused
Note: When running via Docker, the REDMINE_REQUEST_INSTRUCTIONS environment variable must point to a path inside the container, not a path on the host machine.
Therefore, if you want to use a local file, you need to mount it into the container at the correct location.
Security Note: The REDMINE_ALLOWED_DIRECTORIES setting protects against path traversal attacks. Paths containing ../ are resolved before validation, ensuring files can only be accessed within the allowed directories.
Getting Your Redmine API Key
Log in to your Redmine instance
Go to "My account" (typically found in the top-right menu)
On the right side of the page, you should see "API access key"
Click "Show" to view your existing key or "Generate" to create a new one
Copy this key for use in your configuration
API
Tools
redmine_paths_list
Return a list of available API paths from OpenAPI spec
No input required
Returns a YAML string containing a list of path templates:
Fetch an image attachment (e.g. an inline screenshot referenced as !screenshot.png! in an issue
description) and return it as viewable image content, letting the LLM actually see it
Input: attachment_id (integer)
Returns image content on success (max 5 MB, images only), or a YAML error string on failure
redmine_download
Download an attachment from Redmine and save it to a local file
Requires REDMINE_ALLOWED_DIRECTORIES to be set
Inputs:
attachment_id (integer): The ID of the attachment to download
save_path (string): Fully qualified file path (not directory) where the file should be saved (must be within allowed directories)
filename (string, optional): Optional filename for the Redmine download URL (determined automatically from attachment metadata if not provided)
Let's create a new bug report in the "Website" project:
1. Title: "Homepage not loading on mobile devices"
2. Description: "When accessing the homepage from iOS or Android devices, the loading spinner appears but the content never loads. This issue started after the last deployment."
3. Priority: High
4. Assign to: John Smith
Searching for issues
Can you find all high priority issues in the "Website" project that are currently unassigned?
Updating issue status
Please mark issue #123 as "In Progress" and add a comment: "I've started working on this issue. Expect it to be completed by Friday."
Logging time
Log 3.5 hours against issue #456 for "Implementing user authentication" done today.
MCP Directory Listings
MCP Redmine is listed in the following MCP directory sites and repositories:
Contributions are warmly welcomed! Whether it's bug reports, feature requests, documentation improvements, or code contributions - all input is valuable. Feel free to:
Open an issue to report bugs or suggest features
Submit pull requests with improvements
Enhance documentation or share your usage examples
Ask questions and share your experiences
The goal is to make Redmine project management with Claude even better, and your insights and contributions help achieve that.
Acknowledgments
This project builds on the excellent work of others:
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo MCP Redmine?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
MCP Redmine precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte MCP Redmine usa?
MCP Redmine roda localmente via stdio.
Quando MCP Redmine foi verificado pela última vez?
Última verificação: 2026-10-28. A redmine MCP server covering close to 100% of redmines API