Skip to main content
Glama
Redmine MCP Server

Redmine MCP Server

Redmine MCP Server

npm version License Node.js CI

한국어 | 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 → Done

See 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

list_issues, get_issue, create_issue, update_issue, delete_issue

Projects

list_projects, get_project, get_project_versions

Users

list_users, get_current_user, get_user

Time Entries

list_time_entries, get_time_entry, create_time_entry, update_time_entry, delete_time_entry, list_time_entry_activities

Wiki

list_wiki_pages, get_wiki_page, create_or_update_wiki_page, delete_wiki_page

Journals

update_journal

Attachments

get_attachment, download_attachment, update_attachment, delete_attachment

Files

list_files, create_file, upload_file

Utilities

list_statuses, list_priorities, list_trackers, custom_request, search

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 via journals_limit, journals_offset, journals_order

  • include: ["journals"] — same effect, unless include_journals is explicitly set to false

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-redmine

License

Apache License 2.0 — see LICENSE for details.

Available Tools

33 tools
redmine_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_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

    B3.2/5.0

    Scored across 33 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Redmine project management systems through MCP tools, providing access to issues, projects, time tracking, wiki, and more.
      607 PyPI
      92
      MIT