# redmine-mcp-server Wires an AI assistant into your Redmine instance so issues, projects, wikis, time entries and attachments show up as agent tools. Handy when triage should not mean tabbing into a browser. - MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 85 - Author: jztan - License: MIT · policy=link-only · description only; the file stays with the author - Source: https://github.com/jztan/redmine-mcp-server - Updated: 2026-10-22 - HTML: https://affpapa.org/en/nevibecode/mcp/redmine-mcp-server ## What it does The server publishes Redmine as MCP tools: 53 of them on a plain install, 68 once the RedmineUP and DMSF plugins are in play. That second batch covers CRM records, documents and Helpdesk replies. A separate `show_triage_board` tool draws a drag-and-drop issue board in the chat, provided the client implements the MCP Apps extension. Sign-in has several shapes. Pick an API key, username with password, OAuth2 tokens per user, or a browser login where each person enters their own key on a Redmine without OAuth. Set `REDMINE_MCP_READ_ONLY` to keep the agent off write operations. Anything users typed in Redmine arrives wrapped in boundary tags, so a ticket body cannot pose as an instruction to the model. Python 3.10+ gets you a local run; Docker is the other route. OAuth2 leans on Doorkeeper, which means Redmine 6.1 or newer — on older servers that mode is out. A few tools carry their own floor as well: global search wants 3.3.0+, watchers 2.3.0+, project time-entry activities 3.4.0+. Below that, only the tool in question errors out; the server itself stays up. ## Requirements - Needs: Python and uv (commands run via uvx) - Environment variables: `REDMINE_URL`, `REDMINE_USERNAME`, `REDMINE_PASSWORD`, `REDMINE_API_KEY`, `SERVER_HOST`, `SERVER_PORT`, `PUBLIC_HOST`, `PUBLIC_PORT`, `ATTACHMENTS_DIR`, `AUTO_CLEANUP_ENABLED` — keys and tokens: ask the human for the values, never commit them or put them in shared files. ## Install ### Claude Code (native platform) **Platform CLI** ```bash claude mcp add --env REDMINE_URL= --env REDMINE_USERNAME= --env REDMINE_PASSWORD= --env REDMINE_API_KEY= --env SERVER_HOST= --transport stdio redmine-mcp-server -- uvx redmine-mcp-server ``` Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from redmine-mcp-server ### Codex **Platform CLI** ```bash codex mcp add redmine-mcp-server --env REDMINE_URL= --env REDMINE_USERNAME= --env REDMINE_PASSWORD= --env REDMINE_API_KEY= --env SERVER_HOST= -- uvx redmine-mcp-server ``` Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from redmine-mcp-server ### Cursor **Config file** File `.cursor/mcp.json`: ```json { "mcpServers": { "redmine-mcp-server": { "command": "uvx", "args": [ "redmine-mcp-server" ], "env": { "REDMINE_URL": "", "REDMINE_USERNAME": "", "REDMINE_PASSWORD": "", "REDMINE_API_KEY": "", "SERVER_HOST": "" } } } } ``` Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from redmine-mcp-server ### GitHub Copilot **Config file** File `.vscode/mcp.json`: ```json { "servers": { "redmine-mcp-server": { "type": "stdio", "command": "uvx", "args": [ "redmine-mcp-server" ], "env": { "REDMINE_URL": "", "REDMINE_USERNAME": "", "REDMINE_PASSWORD": "", "REDMINE_API_KEY": "", "SERVER_HOST": "" } } } } ``` Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from redmine-mcp-server ### Gemini CLI **Platform CLI** ```bash gemini mcp add -e REDMINE_URL= -e REDMINE_USERNAME= -e REDMINE_PASSWORD= -e REDMINE_API_KEY= -e SERVER_HOST= redmine-mcp-server uvx redmine-mcp-server ``` Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from redmine-mcp-server ## When to use it - work through a Redmine ticket queue from the chat - log hours against an issue - pull up a wiki page or an attachment - check a sprint board without leaving the assistant - answer a Helpdesk message in the same window ## Example prompts - List my open Redmine issues for this week, highest priority first - Log 2 hours on issue #4821 and note the call in the comment - Open the project triage board and tell me what is in progress ## Similar - [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989 - [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918 - [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115 - [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160 - [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392 - [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872 --- NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md