Redmine MCP Server

MCP (Model Context Protocol) Server for Redmine - Manage tasks, log time, update status via Claude/AI assistants.

Features

• List Tasks - View tasks assigned to you with status filtering
• Task Details - Get detailed information about specific issues
• Log Time - Record time entries with comments
• Update Status - Change issue status (in progress, resolved, etc.)
• Update Progress - Set completion percentage (0-100%)
• Add Notes - Add comments to issues
• Daily Summary - Check today's logged hours
• Time Logs Range - View logged hours within a date range

Installation

pip install xukaaaa-redmine-mcp

Or install from source:

git clone https://github.com/xukaaaa/redmine-mcp-server.git
cd redmine-mcp-server
pip install -e .

Configuration

Set the following environment variables:

export REDMINE_URL="https://your-redmine-instance.com"
export REDMINE_API_KEY="your-api-key"

Getting your Redmine API Key

1. Log in to your Redmine instance
2. Go to My Account (top right)
3. Find API access key on the right sidebar
4. Click Show or Reset to get your key

Usage with Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "redmine": {
      "command": "redmine-mcp-server",
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Examples

Ask Claude:

• "Show me my open tasks"
• "What's the status of issue #123?"
• "Log 2 hours on task #456 for code review"
• "Mark issue #789 as resolved"
• "Update task #101 to 80% complete"
• "How many hours have I logged today?"
• "Show me my time logs from 2025-12-23 to 2025-12-27"

Development

# Clone the repo
git clone https://github.com/xukaaaa/redmine-mcp-server.git
cd redmine-mcp-server

# Install in development mode
pip install -e .

# Run the server
redmine-mcp-server

License

MIT License - see LICENSE for details.

Author

xukaaaa - GitHub