Redmine MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Kiro to your Redmine instance. It exposes 15 tools covering Issues, Projects, and Search — allowing your AI assistant to create issues, update projects, search across resources, and more, all through natural conversation.

What it does

Once configured, you can ask your AI assistant things like:

• "List all open issues assigned to me"

• "Create a bug report for the login page crash"

• "Search for issues related to database migration"

• "Archive the old-website project"

• "Add John as a watcher on issue #42"

The server handles authentication, pagination, input validation, and error handling automatically.

Related MCP server: @a-bonus/redmine-mcp

Available tools

Prerequisites

1. Python 3.10+ installed on your machine

2. uv — a fast Python package manager (install guide)

   • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

   • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Redmine API key — get yours from your Redmine instance:

   • Log in to Redmine

   • Go to My Account (top-right menu)

   • In the right sidebar, find API access key and click Show

   • Copy the key

Setup with Kiro

Step 1: Add the MCP server config to Kiro

Create or edit ~/.kiro/settings/mcp.json (this makes it available across all your projects):

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/suryamalempati/redmine-mcp-server.git", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Replace:

• https://your-redmine-instance.com with your Redmine URL

• your-api-key-here with your Redmine API key

You can also place this in .kiro/settings/mcp.json within a specific workspace if you only want it available there.

Step 2: Open Kiro

The MCP server will start automatically when Kiro launches. You can verify it's working by asking: "List my Redmine projects."

Alternative setup: Local install

If you prefer to run from a local clone instead of uvx:

git clone https://github.com/suryamalempati/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install .

Then use this MCP config instead:

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
      "args": [],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Troubleshooting

Development

git clone https://github.com/suryamalempati/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest