MCP Redmine - Quick Start Guide (Windows)

This guide will help you set up and run MCP Redmine on your Windows machine, using the folder structure and commands from your setup.

Prerequisites

• Python 3.8 or newer installed
• uv Python package manager (will be installed below)
• git installed
• Access to a Redmine instance and your API key

1. Install `uv` (Python package manager)

Open PowerShell and run:

pip install uv

2. Clone the MCP Redmine Repository

git clone https://github.com/runekaagaard/mcp-redmine.git
cd "C:/Users/Ade Sulaiman/Desktop/AI/redmine mcp/mcp-redmine"

3. Install Dependencies

uv sync

4. Set Up Environment Variables (for manual run)

Replace with your actual Redmine URL and API key:

$env:REDMINE_URL = "http://localhost:3000"
$env:REDMINE_API_KEY = "your-api-key"

5. Run the MCP Redmine Server

uv run mcp_redmine/server.py main

6. (Optional) Integrate with Claude Desktop

Edit your config at `C:/Users/Ade Sulaiman/AppData/Roaming/Claude/claude_desktop_config.json`:

{
  "mcpServers": {
    "redmine": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:/Users/Ade Sulaiman/Desktop/AI/redmine mcp/mcp-redmine",
        "-m",
        "mcp_redmine.server",
        "main"
      ],
      "env": {
        "REDMINE_URL": "http://localhost:3000",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

7. Verify the Connection

• Restart Claude Desktop if running.
• Try a Redmine command in Claude Desktop (e.g., "List all Redmine projects").
• Check the MCP Redmine server terminal for activity.

(Original README continues below)