umutkocak/redmine-mcp

Redmine MCP Server

A comprehensive Model Context Protocol server for seamless Redmine integration.

74 tools · 20 modules · Full CRUD · Docker Ready · UTF-8 Safe

Overview

Redmine MCP Server exposes the Redmine REST API as MCP tools, enabling AI assistants like Claude to manage projects, issues, users, wiki pages, and more — directly through natural language.

Built with the official MCP Python SDK for guaranteed protocol compliance.

Quick Start

Option 1: Docker (Recommended)

git clone https://github.com/umutkocak/redmine-mcp.git
cd redmine-mcp
cp .env.example .env   # Edit with your credentials
docker build -t redmine-mcp .
docker run -it --env-file .env redmine-mcp

Option 2: Local Installation

git clone https://github.com/umutkocak/redmine-mcp.git
cd redmine-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Edit with your credentials
python src/main.py

Environment Variables

REDMINE_URL=https://redmine.example.com
REDMINE_API_KEY=your_api_key_here
LOG_LEVEL=INFO

Tip: Enable REST API in Redmine under Administration → Settings → API, then generate your key from your user profile.

Supported Operations

Projects — 7 tools

Issues — 7 tools

Users — 6 tools

Time Entries — 5 tools

Attachments — 3 tools

Issue Relations — 4 tools

Versions / Milestones — 5 tools

Memberships — 5 tools

Issue Categories — 5 tools

Wiki Pages — 4 tools

Groups — 7 tools

Roles — 2 tools

Journals — 2 tools

News — 2 tools

System & Metadata — 8 tools

My Account — 2 tools

Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

Local installation:

{
  "mcpServers": {
    "redmine": {
      "command": "/path/to/project/.venv/bin/python",
      "args": ["/path/to/project/src/main.py"],
      "env": {
        "REDMINE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker:

{
  "mcpServers": {
    "redmine": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "REDMINE_URL=https://redmine.example.com",
        "-e",
        "REDMINE_API_KEY=your_api_key_here",
        "redmine-mcp:latest"
      ]
    }
  }
}

Usage Examples

Create an Issue

{
  "issue": {
    "project_id": 1,
    "subject": "Fix login page validation",
    "description": "Email field accepts invalid format",
    "tracker_id": 1,
    "priority_id": 3,
    "assigned_to_id": 5,
    "due_date": "2026-03-01"
  }
}

Log Time

{
  "issue_id": 123,
  "hours": 2.5,
  "activity_id": 9,
  "comments": "Backend API implementation"
}

Search Across Redmine

{
  "query": "authentication",
  "titles_only": false,
  "limit": 10
}

Project Structure

src/
├── main.py              # MCP server entry point
├── redmine_client.py    # Redmine REST API client
├── version.py           # Version management
└── tools/
    ├── projects.py          # Project CRUD + archive
    ├── issues.py            # Issue CRUD + watchers
    ├── users.py             # User CRUD + current user
    ├── time_entries.py      # Time entry CRUD
    ├── attachments.py       # File upload/download
    ├── enumerations.py      # Trackers, statuses, roles
    ├── issue_relations.py   # Issue relations
    ├── versions.py          # Milestones
    ├── memberships.py       # Project memberships
    ├── issue_categories.py  # Issue categories
    ├── wiki_pages.py        # Wiki management
    ├── groups.py            # Group management
    ├── roles.py             # Role details + permissions
    ├── custom_fields.py     # Custom field definitions
    ├── journals.py          # Issue change history
    ├── news.py              # News entries
    ├── queries.py           # Saved queries
    ├── search.py            # Global search
    ├── files.py             # Project files
    └── my_account.py        # Account management

Requirements

• Python 3.10+
• Redmine 4.0+ (5.0+ for archive/unarchive)
• REST API enabled on your Redmine instance

Dependencies

Troubleshooting

Set LOG_LEVEL=DEBUG in your .env file for verbose output.

License

This project is licensed under the .

Links

• Model Context Protocol — MCP specification
• Redmine REST API — API reference
• MCP Python SDK — Official SDK

_{Built with ❤️ for the MCP ecosystem}