Skip to main content
Glama
Redmine MCP Server

Redmine MCP Server

Redmine MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Kiro to your Redmine instance. It exposes 18 tools covering Issues, Projects, Time Entries, 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

Domain

Tools

Issues

list, get, create, update, update note, delete, add watcher, remove watcher

Projects

list, get, create, update, delete, archive, unarchive

Search

full-text search across all Redmine resources

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/bizcloud-experts/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: If git is not installed

If you get a "Git executable not found" error, you can use a zip-based install that doesn't require git on your machine:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

Alternative setup: Local install

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

git clone https://github.com/bizcloud-experts/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

Problem

Solution

"REDMINE_URL environment variable is missing"

Make sure REDMINE_URL is set in the MCP config's env block

"REDMINE_API_KEY environment variable is missing"

Ensure REDMINE_API_KEY is set in the MCP config's env block

"Authentication failed: invalid or expired API key"

Verify your API key is correct in Redmine → My Account → API access key

"Connection failed"

Check that the REDMINE_URL is reachable from your machine

Tools not appearing in Kiro

Confirm the mcp.json file is in the right location and "disabled" is false

"Git executable not found"

Git is not installed or not on PATH. Use the zip-based install instead, or install git and restart your terminal

Development

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

Available Tools

17 tools
add_watcherAdd WatcherC

Add a watcher to an issue.

Inputs: user_id (required), issue_id (required). Returns: object

archive_projectArchive ProjectC

Archive a project.

Inputs: project_id (required). Returns: object

create_issueCreate IssueC

Create a new issue in a project.

Inputs: subject (required), project_id (required), status_id, done_ratio, +11 more. Returns: object

create_projectCreate ProjectD

Create a new project.

Inputs: name (required), identifier (required), homepage, is_public, +9 more. Returns: object

delete_issueDelete IssueC

Delete an issue permanently.

Inputs: issue_id (required). Returns: object

delete_projectDelete ProjectC

Delete a project permanently.

Inputs: project_id (required). Returns: object

get_issueGet IssueC

Get detailed information about a specific issue.

Inputs: issue_id (required), include. Returns: object

get_projectGet ProjectC

Get detailed information about a specific project.

Inputs: project_id (required), include. Returns: object

get_time_entryGet Time EntryC

Get detailed information about a specific time entry.

Inputs: time_entry_id (required). Returns: object

list_issuesList IssuesC

List issues with optional filters and pagination.

Inputs: sort, limit, offset, fetch_all, +6 more. Returns: object

list_projectsList ProjectsB

List all accessible projects with pagination.

Inputs: limit, offset, include. Returns: object

list_time_entriesList Time EntriesB

List time entries with optional filters and pagination.

Inputs: limit, offset, to_date, user_id, +4 more. Returns: object

remove_watcherRemove WatcherC

Remove a watcher from an issue.

Inputs: user_id (required), issue_id (required). Returns: object

unarchive_projectUnarchive ProjectC

Unarchive a project.

Inputs: project_id (required). Returns: object

update_issueUpdate IssueD

Update an existing issue.

Inputs: issue_id (required), notes, subject, due_date, +15 more. Returns: object

update_projectUpdate ProjectC

Update an existing project.

Inputs: project_id (required), name, homepage, is_public, +9 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools target a distinct resource+action pair (issues, projects, watchers, time entries), making boundaries clear. The generic 'search' tool mildly overlaps with filtered list_issues/list_projects, but descriptions keep them separable.

    Naming Consistency5/5

    Every tool follows a strict verb_noun convention: list_/get_/create_/update_/delete_/add_/remove_/archive_/unarchive_ plus a clear resource noun. Highly predictable with no deviations.

    Tool Count4/5

    17 tools sits at the heavier end of the range but is justified by covering multiple resources: full issue CRUD, project CRUD plus archive/unarchive, watchers, and time entries. Nothing feels redundant.

    Completeness4/5

    Issues and projects have full lifecycle coverage including archive/unarchive and watchers. Time entries only support read (list/get) with no create/update/delete, a notable gap for a time-tracking-centric tool like Redmine.

    Related MCP Connectors

    Related MCP Servers