Redmine MCP Server
stdio-based Model Context Protocol server that wraps a Redmine instance through its REST API (*.json endpoints). It runs as a separate Node.js process; no changes to the Redmine Rails app are required.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
REDMINE_BASE_URL=<value> REDMINE_API_KEY=<secret> REDMINE_IMPERSONATE_USER=<value> REDMINE_READONLY=<value> REDMINE_ALLOW_RAW_REQUEST=<value> REDMINE_HTTP_TIMEOUT_MS=<value> REDMINE_MAX_PAGES=<value> REDMINE_MAX_DOWNLOAD_BYTES=<value> claude mcp add io.github.nikhilprasad-r-redmine-mcp-connector -- npx -y redmine-mcp-connector@1.0.1Execute em um terminal.
{ "mcpServers": { "io.github.nikhilprasad-r-redmine-mcp-connector": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "REDMINE_BASE_URL": "<value>", "REDMINE_API_KEY": "<secret>", "REDMINE_IMPERSONATE_USER": "<value>", "REDMINE_READONLY": "<value>", "REDMINE_ALLOW_RAW_REQUEST": "<value>", "REDMINE_HTTP_TIMEOUT_MS": "<value>", "REDMINE_MAX_PAGES": "<value>", "REDMINE_MAX_DOWNLOAD_BYTES": "<value>" } } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
stdio-based Model Context Protocol server that wraps a Redmine instance through its REST API (*.json endpoints). It runs as a separate Node.js process; no changes to the Redmine Rails app are required.
stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.
REDMINE_BASE_URLNo install needed for normal use — coding agents launch it on demand via npx:
npx -y redmine-mcp-connector
See CONNECTING.md for exact setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and any other MCP client, plus a local-build and Docker alternative.
To hack on the server itself, clone this repo instead:
npm install
npm run build
Environment variables (see .env.example):
REDMINE_BASE_URL=https://your-redmine.example.com REDMINE_API_KEY=secret npm start
# or during development:
REDMINE_BASE_URL=... REDMINE_API_KEY=... npm run dev
Full per-client instructions (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and generic MCP clients) live in CONNECTING.md. Quick example (Claude Desktop / Cursor / Windsurf all share this shape):
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "redmine-mcp-connector"],
"env": {
"REDMINE_BASE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your_api_key_here"
}
}
}
}
Naming: redmine_<resource>_<action>.
Issues: redmine_issues_list, redmine_issue_get, redmine_issue_create, redmine_issue_update, redmine_issue_add_comment, redmine_issue_delete (requires confirm: true), watchers add/remove, relations list/add/remove.
Projects: redmine_projects_list, redmine_project_get, create/update/archive/unarchive/delete (confirm for delete).
Users: redmine_current_user, redmine_users_list, redmine_user_get, create/update/delete (confirm for delete).
Time entries: list/get/create/update/delete (confirm for delete).
News: list/get/create/update/delete (confirm for delete).
Wiki: list pages, get page, create/update (PUT), delete (confirm).
Versions & categories: versions CRUD (confirm on delete), issue categories CRUD (confirm on delete).
Queries & metadata: redmine_queries_list, redmine_enumerations_list, redmine_trackers_list, redmine_issue_statuses_list, redmine_roles_list, redmine_role_get, redmine_custom_fields_list.
Groups (read-only): redmine_groups_list, redmine_group_get.
Memberships: list/create/update/delete (confirm on delete).
Attachments & search: redmine_search, attachment get/update/delete/upload/download (download returns base64, size-capped).
Repository (limited REST in stock Redmine): redmine_repository_revision_link_issue, redmine_repository_revision_unlink_issue (confirm). Listing repositories/revisions over JSON is not exposed by core Redmine; use redmine_request if you enable it, or plugins.
Escape hatch: redmine_request — only if REDMINE_ALLOW_RAW_REQUEST=true; DELETE requires confirm: true.
confirm: true where noted.REDMINE_READONLY=true for read-only deployments.Build a local image:
docker build -t redmine-mcp-server:local .
Run it (stdio MCP server):
docker run --rm -i -e REDMINE_BASE_URL="https://redmine.example.com" -e REDMINE_API_KEY="your_api_key_here" redmine-mcp-server:local
Use this image in MCP config:
{
"mcpServers": {
"redmine": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "REDMINE_BASE_URL",
"-e", "REDMINE_API_KEY",
"docker.io/<docker-user>/redmine-mcp-server:latest"
],
"env": {
"REDMINE_BASE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your_api_key_here"
}
}
}
}
docker login
docker buildx create --name redmine-mcp-builder --use --bootstrap
export IMAGE=docker.io/<docker-user>/redmine-mcp-server
export TAG=1.0.0
docker buildx build --platform linux/amd64,linux/arm64 -t $IMAGE:$TAG -t $IMAGE:latest --push .
npm run lint
npm test
Contributions are welcome.
CONNECTING.md for detailed client setup instructions.CONTRIBUTING.md for local setup, coding expectations, and PR workflow.CODE_OF_CONDUCT.md to keep collaboration respectful and inclusive.SUPPORT.md for help channels and what details to include.SECURITY.md.REGISTRY_PUBLISHING.md.GPL-2.0-or-later (same family as Redmine).
stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.
{ "mcpServers": { "io.github.nikhilprasad-r-redmine-mcp-connector": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "REDMINE_BASE_URL": "<value>", "REDMINE_API_KEY": "<secret>", "REDMINE_IMPERSONATE_USER": "<value>", "REDMINE_READONLY": "<value>", "REDMINE_ALLOW_RAW_REQUEST": "<value>", "REDMINE_HTTP_TIMEOUT_MS": "<value>", "REDMINE_MAX_PAGES": "<value>", "REDMINE_MAX_DOWNLOAD_BYTES": "<value>" } } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
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.
O publicador lista estas variáveis de ambiente: REDMINE_BASE_URL, REDMINE_API_KEY, REDMINE_IMPERSONATE_USER, REDMINE_READONLY, REDMINE_ALLOW_RAW_REQUEST, REDMINE_HTTP_TIMEOUT_MS, REDMINE_MAX_PAGES, REDMINE_MAX_DOWNLOAD_BYTES.
Redmine MCP Connector roda localmente via stdio.
Última verificação: 2026-11-09. stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.