Redmine MCP Server
An MCP server that connects AI assistants to a Redmine instance so they can manage issues, projects, time tracking, wiki pages, files, and more.
Issues — list with filters (status, project, tracker, assignee, dates, sort, pagination), get details (comments opt-in with paging/truncation controls), create, update (including notes, private notes, watchers, custom fields, attachments), and delete
Projects — list projects, get project details (trackers, categories, modules, activities), and fetch versions/milestones
Users — list users (by name or group), get user details (memberships, groups), and get the current authenticated user
Time tracking — list, get, create, update, and delete time entries, plus list available activities
Wiki — list pages, get page content (optionally by version), create/update pages (with parent pages and change comments), and delete pages
Journals — update an existing issue journal/comment, optionally marking it private
Attachments — get, update (filename/description), and delete attachments
Files — list project files, upload file content (base64) to obtain a token, and attach uploaded files to a project or version
Utilities — list issue statuses, priorities, and trackers; run custom API requests (GET/POST/PUT/DELETE) to any Redmine endpoint; and search issues, wiki pages, news, documents, changesets, messages, projects, and attachments with scope and word-matching options
Issue links — server instructions build links from
REDMINE_URL(<REDMINE_URL>/issues/<id>) instead of guessing the host
Enables comprehensive interaction with Redmine project management systems, including issue management (create, update, delete, search), project management, time tracking, user management, wiki page operations, and access to issue statuses, priorities, and trackers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Redmine MCP Server list my open issues in the marketing project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Redmine MCP Server
한국어 | Usage Guide | Contributing
A Model Context Protocol (MCP) server for Redmine. Enables AI assistants to manage issues, projects, time tracking, wiki pages, files, and more.
Quick Start
Stdio (Claude Desktop / VS Code)
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "@gmlee-ncurity/mcp-server-redmine"],
"env": {
"REDMINE_URL": "https://your-redmine.com",
"REDMINE_API_KEY": "your-api-key"
}
}
}
}HTTP (Claude Code / Multi-user)
REDMINE_URL=https://your-redmine.com npm run start:http
claude mcp add --transport http redmine http://localhost:3000/mcp
# Browser opens → Enter Redmine API Key → DoneSee USAGE.md for detailed configuration, Docker deployment, and reverse proxy setup.
Related MCP server: Redmine MCP Server
Features
Issues — List, create, update, delete, search with filters
Projects — List, view details, versions/milestones
Time Tracking — Log entries, manage records, list activities
Users — List, get details, current user info
Wiki — List, create, update, delete pages
Files & Attachments — Upload, list, manage files and attachments
Journals — Update notes
Utilities — Statuses, priorities, trackers, custom API requests, search
Issue links — Server instructions tell the assistant to build issue links from
REDMINE_URL(<REDMINE_URL>/issues/<id>), so it does not guess the host
Available Tools
Category | Tools |
Issues |
|
Projects |
|
Users |
|
Time Entries |
|
Wiki |
|
Journals |
|
Attachments |
|
Files |
|
Utilities |
|
All tools are prefixed with redmine_ (e.g., redmine_list_issues).
Breaking Changes
redmine_get_issue — Comments Now Opt-in
Issue comments are no longer returned by default. To retrieve comments, use one of:
include_journals=true— returns comments with pagination control viajournals_limit,journals_offset,journals_orderinclude: ["journals"]— same effect, unlessinclude_journalsis explicitly set tofalse
For details and new pagination parameters, see docs/API.md.
Installation
# Direct usage (no install)
npx @gmlee-ncurity/mcp-server-redmine
# Global install
npm install -g @gmlee-ncurity/mcp-server-redmineLicense
Apache License 2.0 — see LICENSE for details.
Available Tools
33 toolsredmine_create_fileA
Add a previously uploaded file to a project
Inputs: token (required), project_id (required), filename, version_id, +1 more.
redmine_create_issueC
Create a new issue in Redmine
Inputs: subject (required), project_id (required), uploads, due_date, +14 more.
redmine_create_or_update_wiki_pageB
Create a new wiki page or update existing one
Inputs: text (required), title (required), project_id (required), comments, +1 more.
redmine_create_time_entryC
Create a new time entry
Inputs: hours (required), activity_id (required), user_id, comments, +4 more.
redmine_custom_requestC
Make a custom API request to Redmine
Inputs: path (required), method (required), data, params.
redmine_delete_attachmentA
Delete an attachment from Redmine
Inputs: id (required).
redmine_delete_issueB
Delete an issue from Redmine
Inputs: id (required).
redmine_delete_time_entryB
Delete a time entry
Inputs: id (required).
redmine_delete_wiki_pageC
Delete a wiki page
Inputs: title (required), project_id (required).
redmine_get_attachmentA
Get detailed information about a specific attachment
Inputs: id (required).
redmine_get_current_userA
Get information about the currently authenticated user
Inputs: no named parameters.
redmine_get_issueA
Get a specific issue. Comments (journals) are OFF by default to save tokens; the total count is always shown. Enable and page through comments with the journals_* params.
Inputs: id (required), include, journals_limit, journals_order, +4 more.
redmine_get_projectB
Get detailed information about a specific project
Inputs: id (required), include.
redmine_get_project_versionsA
Get versions/milestones for a specific project
Inputs: project_id (required).
redmine_get_time_entryA
Get detailed information about a specific time entry
Inputs: id (required).
redmine_get_userB
Get detailed information about a specific user
Inputs: id (required), include.
redmine_get_wiki_pageB
Get content of a specific wiki page
Inputs: title (required), project_id (required), version.
redmine_list_filesB
List files for a specific project
Inputs: project_id (required).
redmine_list_issuesA
List issues from Redmine with optional filters
Inputs: sort, limit, offset, subject, +6 more.
redmine_list_prioritiesA
List all available issue priorities
Inputs: no named parameters.
redmine_list_projectsB
List all available Redmine projects
Inputs: limit, offset.
redmine_list_statusesA
List all available issue statuses
Inputs: no named parameters.
redmine_list_time_entriesB
List time entries with optional filters
Inputs: to, from, limit, offset, +5 more.
redmine_list_time_entry_activitiesA
List available time entry activities
Inputs: no named parameters.
redmine_list_trackersA
List all available issue trackers
Inputs: no named parameters.
redmine_list_usersC
List users in Redmine
Inputs: name, limit, offset, group_id.
redmine_list_wiki_pagesA
List all wiki pages for a project
Inputs: project_id (required).
redmine_searchC
Search Redmine for issues, wiki pages, and more
Inputs: q (required), news, limit, scope, +11 more.
redmine_update_attachmentB
Update an existing attachment (filename or description)
Inputs: id (required), filename, description.
redmine_update_issueC
Update an existing issue in Redmine
Inputs: id (required), notes, subject, uploads, +15 more.
redmine_update_journalA
Update an existing journal (comment) on an issue
Inputs: id (required), notes, private_notes.
redmine_update_time_entryB
Update an existing time entry
Inputs: id (required), hours, comments, issue_id, +4 more.
redmine_upload_fileA
Upload a file to Redmine and get an upload token. The token can then be used with redmine_create_file or when creating/updating issues with attachments.
Inputs: content_base64 (required), filename.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 33 tools
Each tool targets a distinct resource-action pair (e.g., issues, wiki pages, time entries, users, attachments, projects). Overlap is minimal—the only compound tool, redmine_create_or_update_wiki_page, clearly handles both create and update. The catch-all redmine_custom_request is explicitly generic and optional, so it does not create ambiguity.
All tools follow a consistent redmine_<verb>_<resource> pattern in snake_case. Verbs are uniformly list, get, create, update, delete, with one exception (redmine_create_or_update_wiki_page) that uses a compound verb but remains readable and consistent in style. The single non-verb-noun tool, redmine_custom_request, is a deliberate generic fallback and does not break the established convention.
At 33 tools, the surface is oversized for a typical MCP server, exceeding the 25-tool threshold that indicates 'too many.' While Redmine is a feature-rich system, many tools could be consolidated (e.g., time entry activities and statuses/priorities/trackers could be grouped), and the breadth makes the server harder to navigate.
The tool set covers the major Redmine domains: issues (CRUD plus statuses, priorities, trackers), projects (list/get only), wiki pages (CRUD), time entries (full CRUD plus activities), users (read-only), attachments (get/update/delete), and files (upload/create/list). Notable gaps are the absence of project create/update/delete and user management, but the presence of redmine_custom_request mitigates these limitations for advanced use.
Maintenance
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Manage Orangescrum projects, tasks, users, sprints, test cases, releases, and risks from AI tools.
Manage Loom projects, tasks, bugs, defects, clients and phases from AI assistants
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Redmine instances to manage issues, projects, and users. It provides comprehensive tools for issue tracking, project oversight, and user management through the Redmine REST API.13 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI applications to interact with Redmine project management systems for issue tracking, time logging, and project management through natural language.12 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Redmine project management systems through MCP tools, providing access to issues, projects, time tracking, wiki, and more.607 PyPI92MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with Redmine instances, managing issues, projects, and metadata through natural language commands.1212 npmMIT