Redmine MCP Server

A read-only Model Context Protocol (MCP) server for querying Redmine issue data via the Redmine REST API. Designed to integrate seamlessly with AI assistants (e.g., Claude, Cursor, GitHub Copilot) that support MCP.

Features

• 🔍 Read-only access to Redmine — list issues, get issue details, query metadata

• 🔐 Flexible authentication — API key or HTTP Basic Auth (or both combined)

• 📦 Toolset system — enable only the tools you need

• 🔤 Configurable tool prefix — avoid naming conflicts across multiple MCP servers

• 🪙 Token limiting — automatically truncates oversized responses to avoid context overflow

• 🚀 Zero local install — run directly via npx without cloning the repo

Related MCP server: Redmine MCP Server

Available Tools

Toolset: issue

Toolset: issue_metadata

Tools are prefixed with the value of PREFIX (e.g., redmine_get_issues). See Configuration for details.

Quick Start

Requirements

• Node.js 20+ (uses built-in fetch and ES modules)

• A running Redmine instance with the REST API enabled

• A valid API key or username/password credentials

Installation (via npx)

Add this to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["github:danglephuc/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your-api-key-here",
        // "REDMINE_USERNAME": "your-username",
        // "REDMINE_PASSWORD": "your-password",
        "MAX_TOKENS": "50000",
        "PREFIX": "redmine_",
        "ENABLE_TOOLSETS": "issue,issue_metadata",
      },
    },
  },
}

See Configuration for all available environment variables and CLI flags.

Documentation

Development

npm install
npm run dev          # run with tsx (hot reload)
npm run inspect      # launch MCP Inspector UI at http://localhost:6274
npm run build        # type-check and compile to build/
npm run test         # run all tests with vitest
npm run test:coverage  # run tests with coverage
npm run lint         # lint with eslint
npm run format       # check formatting with prettier

License

MIT