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.
Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong 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.1Chạy trong 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 từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên 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.
MởTừ nhà phát hành
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>" } } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Nhà phát hành liệt kê các biến môi trường sau: 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 chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-11-09. stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.