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

Tool	Description
list_my_tasks	List tasks assigned to you (filter: open/closed/status name)
get_issue_details	Get detailed info about a specific issue
log_time	Log time entry with hours and comment
update_issue_status	Change issue status
update_progress	Update completion percentage
add_note	Add a comment to an issue
get_today_logs	View today's time entries and total hours
get_time_logs_range	View time logs within a date range (from_date, to_date)
clear_cache	Clear cached metadata

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