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.
Alimenter votre agent
La commande propre à l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un 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.1À exécuter dans un 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 distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur 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.
LancerDe l'éditeur
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>" } } }}Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
L'éditeur indique ces variables d'environnement : 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 s'exécute en local via stdio.
Dernière vérification : 2026-11-09. stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.