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
Python 3.10+ instalado en tu máquina
uv — un gestor de paquetes de Python rápido (guía de instalación)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
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.comcon tu URL de Redmineyour-api-key-herecon 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_API_KEY environment variable is missing" | Asegúrate de que |
"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 |
Tools not appearing in Kiro | Confirma que el archivo |
"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]"
pytestAvailable Tools
17 toolsadd_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
searchSearchD
Search across Redmine resources.
Inputs: query (required), news, limit, scope, +10 more. 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
Scored across 17 tools
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.
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.
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.
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
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for AI dialogue using various LLM models via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3325 npm6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Redmine that enables interaction with issues, wiki pages, and time entries through natural language.ISC
- AlicenseAqualityCmaintenanceMCP server for Redmine integration, enabling AI assistants to manage issues, upload files, automate workflows, and handle wiki pages.18MIT
- FlicenseAqualityDmaintenanceAn MCP server that connects AI agents to Redmine project data, enabling natural language access to issues, projects, time entries, and more via the REST API.21-