Skip to main content
Glama
Redmine MCP Server

Redmine MCP Server

Redmine MCP Server

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA como Kiro a tu instancia de Redmine. Expone 15 herramientas que cubren Incidencias, Proyectos y Búsqueda, lo que permite a tu asistente de IA crear incidencias, actualizar proyectos, buscar en recursos y más, todo mediante conversación natural.

Qué hace

Una vez configurado, puedes pedirle a tu asistente de IA cosas como:

  • "Lista todas las incidencias abiertas asignadas a mí"

  • "Crea un informe de error para el fallo de la página de inicio de sesión"

  • "Busca incidencias relacionadas con la migración de la base de datos"

  • "Archiva el proyecto old-website"

  • "Añade a John como observador en la incidencia #42"

El servidor maneja la autenticación, la paginación, la validación de entrada y el manejo de errores automáticamente.

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

Herramientas disponibles

Dominio

Herramientas

Incidencias

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

Proyectos

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

Búsqueda

búsqueda de texto completo en todos los recursos de Redmine

Requisitos previos

  1. Python 3.10+ instalado en tu máquina

  2. uv — un gestor de paquetes de Python rápido (guía de instalación)

    • 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. Clave de API de Redmine — obtén la tuya desde tu instancia de Redmine:

    • Inicia sesión en Redmine

    • Ve a Mi cuenta (menú superior derecho)

    • En la barra lateral derecha, encuentra Clave de acceso a la API y haz clic en Mostrar

    • Copia la clave

Configuración con Kiro

Paso 1: Añade la configuración del servidor MCP a Kiro

Crea o edita ~/.kiro/settings/mcp.json (esto lo hace disponible en todos tus proyectos):

{
  "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
    }
  }
}

Reemplaza:

  • https://your-redmine-instance.com con tu URL de Redmine

  • your-api-key-here con tu clave de API de Redmine

También puedes colocar esto en .kiro/settings/mcp.json dentro de un espacio de trabajo específico si solo quieres que esté disponible allí.

Paso 2: Abre Kiro

El servidor MCP se iniciará automáticamente cuando Kiro se lance. Puedes verificar que funciona preguntando: "Lista mis proyectos de Redmine."

Alternativa: Si git no está instalado

Si recibes un error "Git executable not found", puedes usar una instalación basada en zip que no requiere git en tu máquina:

{
  "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
    }
  }
}

Configuración alternativa: Instalación local

Si prefieres ejecutar desde un clon local en lugar de 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 .

Entonces usa esta configuración MCP en su lugar:

{
  "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
    }
  }
}

Solución de problemas

Problema

Solución

"REDMINE_URL environment variable is missing"

Asegúrate de que REDMINE_URL esté configurada en el bloque env de la configuración MCP

"REDMINE_API_KEY environment variable is missing"

Asegúrate de que REDMINE_API_KEY esté configurada en el bloque env de la configuración MCP

"Authentication failed: invalid or expired API key"

Verifica que tu clave de API sea correcta en Redmine → Mi cuenta → Clave de acceso a la API

"Connection failed"

Comprueba que REDMINE_URL sea accesible desde tu máquina

Tools not appearing in Kiro

Confirma que el archivo mcp.json esté en la ubicación correcta y que "disabled" sea false

"Git executable not found"

Git no está instalado o no está en PATH. Usa la instalación basada en zip en su lugar, o instala git y reinicia tu terminal

Desarrollo

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