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

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.