Redmine MCP Server
Manages Redmine issues, projects, time tracking, wiki pages, files, attachments, journals, users, and more via API.
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 all open issues in the API 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", "@flor3z-github/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
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 @flor3z-github/mcp-server-redmine
# Global install
npm install -g @flor3z-github/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 has a distinct purpose, clearly differentiated by the noun (e.g., issues vs. projects vs. time entries) and verb (list, get, create, update, delete). No two tools operate on the same resource-action combination, so an agent can reliably select the correct one.
All tools follow the strict pattern 'redmine_verb_noun' (e.g., redmine_list_issues, redmine_get_wiki_page, redmine_create_time_entry), using imperative present-tense verbs and consistent snake_case. No deviations or mixed conventions.
With 33 tools, the server covers a broad domain (issues, projects, wiki, time tracking, attachments, users, metadata, search). While slightly above the typical 15-25 range, each tool addresses a distinct feature of Redmine, and the count is justified by the platform's complexity.
The tool set provides CRUD operations for all major Redmine entities (issues, wiki pages, time entries, attachments, files) plus query capabilities for metadata and search. There are no obvious gaps for standard workflows; even edge cases like uploading files and custom requests are covered.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI assistants to interact with Redmine project management systems, providing comprehensive access to issues, projects, time tracking, users, and wiki pages through natural language commands.33499 npm1Apache 2.0
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Redmine for task management, time logging, status updates, and progress tracking via the MCP protocol.9MIT
- 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