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", "@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 → 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

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, 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 @flor3z-github/mcp-server-redmine

# Global install
npm install -g @flor3z-github/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

    A3.5/5.0

    Scored across 33 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      33
      499 npm
      1
      Apache 2.0
    • 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