Redmine MCP Server
onozaty/redmine-mcp-server
Integração completa Redmine com suporte leitura/escrita e controle de permissões
Ver no GitHubServidor MCP que fornece acesso completo à API REST do Redmine, permitindo gerenciar issues, projetos e recursos diretamente via Claude e outros clientes MCP. Suporta modo somente leitura e filtragem de ferramentas via regex para controle granular de operações.
Instalação
npx convez-ai onozaty/redmine-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar e gerenciar issues no Redmine via Claude
- Consultar informações de projetos e tarefas automaticamente
- Automatizar fluxos de trabalho de gerenciamento de projetos
- Integrar Redmine com automações baseadas em IA
Veredito

MCP server bem estruturado e maduro que cobre a API completa do Redmine. Implementação sólida com boas práticas de segurança (modo read-only, filtragem de ferramentas) e suporta tanto npx quanto Docker, tornando-o acessível para diferentes cenários de deployment.
README
A tradução para o português deste README ainda está na fila.
Redmine MCP Server
Model Context Protocol (MCP) server for Redmine that provides comprehensive access to the Redmine REST API.
Overview
This project is an MCP server that comprehensively covers Redmine's REST API. It allows you to operate Redmine from MCP clients (such as Claude Desktop).
Demonstration
Here are example videos showing how to use the Redmine MCP server with Claude Desktop:
Creating an Issue
https://github.com/user-attachments/assets/075fb079-104c-404d-91f5-755b3882853b
This demonstration also uses the Playwright MCP for browser automation alongside the Redmine MCP server.
Getting Issue Information
https://github.com/user-attachments/assets/8f551082-6982-4513-8fe7-b0f111be982d
Features
- 📋 Comprehensive API Coverage: Supports all functions available in Redmine's REST API
- 🔒 Read-Only Mode: Supports safe data reference mode
- 🔧 Tool Filtering: Control which tools are available using regex patterns
Prerequisites
Getting Redmine API Key
- Log in to Redmine with administrator privileges
- Go to "Administration" → "Settings" → "API" tab
- Check "Enable REST web service"
- Generate "API access key" in personal settings
For details, refer to Redmine REST API documentation.
Configuration
Environment Variables
The following environment variables are required (specified in MCP client configuration files):
- REDMINE_URL (Required): Base URL of the Redmine instance
- Example:
https://redmine.example.com
- Example:
- REDMINE_API_KEY (Required): API key generated in Redmine
- Set the API key obtained in prerequisites
- REDMINE_MCP_READ_ONLY (Optional): Enable read-only mode
true: Read-only mode (disables data modification operations)falseor unset: Allow all operations (default)
- REDMINE_MCP_TOOLS_ALLOW_PATTERN (Optional): Regex pattern to allow only matching tools
- Example:
^get(enable only tools starting with "get") - If unset, all tools are allowed (subject to other settings)
- Example:
- REDMINE_MCP_TOOLS_DENY_PATTERN (Optional): Regex pattern to disable matching tools
- Example:
^delete(disable all tools starting with "delete") - If unset, no tools are denied (subject to other settings)
- Deny pattern takes priority over allow pattern
- Example:
MCP Client Configuration
Using npx (Recommended for quick start)
Add the following as MCP configuration for your AI agent:
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
Using Docker (Alternative)
If you prefer using Docker:
{
"mcpServers": {
"redmine": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "REDMINE_URL=https://your-redmine.example.com",
"-e", "REDMINE_API_KEY=your-api-key-here",
"-e", "REDMINE_MCP_READ_ONLY=true",
"ghcr.io/onozaty/redmine-mcp-server:latest"
]
}
}
}
When to use Docker:
- Enterprise environments requiring container isolation
- Reproducible deployments across different systems
- Environments where Node.js installation is restricted
Below are specific configuration methods for several MCP clients:
Claude Desktop
Add the following to claude_desktop_config.json:
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
Claude Code
In Claude Code, you can add MCP servers using the following commands:
Local configuration:
claude mcp add redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
Project configuration:
claude mcp add -s project redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
User configuration (global):
claude mcp add -s user redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server
Visual Studio Code
Project configuration (.vscode/mcp.json):
{
"servers": {
"redmine": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
User configuration (settings.json):
{
"mcp": {
"servers": {
"redmine": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@onozaty/redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_API_KEY": "your-api-key-here",
"REDMINE_MCP_READ_ONLY": "true"
}
}
}
}
}
Available Features
This MCP server comprehensively supports the functions provided by Redmine's REST API:
Main Features
- Issues: Create, update, delete, search, and manage related issues
- Projects: Create, update, delete, archive, and manage memberships
- Users: Create, update, delete, and manage groups
- Time Entries: Record, update, and delete time entries
- Wiki: Create, update, delete pages, and manage versions
- News: Create, update, and delete news
- Files: Upload and download files
- Attachments: Upload, download files, and get thumbnails
- Queries: Execute saved queries
- Custom Fields: Get and manage custom fields
- Roles: Get and manage roles
- Trackers: Get and manage trackers
- Issue Statuses: Get and manage issue statuses
- Search: Cross-search functionality
Read-Only Mode
By setting REDMINE_MCP_READ_ONLY=true, you can disable data modification operations. This allows safe data reference.
Tool Filtering
You can control which tools are available using the following environment variables:
REDMINE_MCP_TOOLS_ALLOW_PATTERN: Only tools whose names match this regex are enabled.- Example:
^getenables only read-oriented tools likegetIssues,getProjects, etc.
- Example:
REDMINE_MCP_TOOLS_DENY_PATTERN: Tools whose names match this regex are disabled.- Example:
^deletedisables all delete operations.
- Example:
When both are set, deny takes priority. These can also be combined with REDMINE_MCP_READ_ONLY.
Example: Allow only issue-related tools
"env": {
"REDMINE_MCP_TOOLS_ALLOW_PATTERN": "Issue"
}
Example: Disable all delete and archive operations
"env": {
"REDMINE_MCP_TOOLS_DENY_PATTERN": "^(delete|archive)"
}
Available Tools
The following tools are available (based on Redmine REST API categories):
| Category | Tools |
|---|---|
| Issues | getIssues, getIssue, createIssue, updateIssue, deleteIssue, addWatcher, removeWatcher, addRelatedIssue, removeRelatedIssue |
| Projects | getProjects, getProject, createProject, updateProject, deleteProject, archiveProject, unarchiveProject, closeProject, reopenProject |
| Project Memberships | getMemberships, getMembership, createMembership, updateMembership, deleteMembership |
| Users | getUsers, getUser, createUser, updateUser, deleteUser, getCurrentUser |
| Time Entries | getTimeEntries, getTimeEntry, createTimeEntry, updateTimeEntry, deleteTimeEntry |
| News | getNewsList, getNewsListByProject, getNews, createNews, updateNews, deleteNews |
| Issue Relations | getIssueRelations, getIssueRelation, createIssueRelation, deleteIssueRelation |
| Versions | getVersionsByProject, getVersions, createVersion, updateVersion, deleteVersion |
| Wiki Pages | getWikiPages, getWikiPage, getWikiPageByVersion, updateWikiPage, deleteWikiPage |
| Queries | getQueries |
| Attachments | getAttachment, updateAttachment, deleteAttachment, uploadAttachmentFromLocalFile, uploadAttachmentFromBase64Content, downloadAttachmentToLocalFile, downloadAttachmentAsBase64Content, downloadThumbnailToLocalFile, downloadThumbnailAsBase64Content |
| Issue Statuses | getIssueStatuses |
| Trackers | getTrackers |
| Enumerations | getIssuePriorities, getTimeEntryActivities, getDocumentCategories |
| Issue Categories | getIssueCategories, getIssueCategory, createIssueCategory, updateIssueCategory, deleteIssueCategory |
| Roles | getRoles, getRole |
| Groups | getGroups, getGroup, createGroup, updateGroup, deleteGroup, addUserToGroup, removeUserFromGroup |
| Custom Fields | getCustomFields |
| Search | search |
| Files | getFiles, createFile |
| My Account | getMyAccount, updateMyAccount |
| Journals | updateJournal |
License
MIT License
Author
Acknowledgments
- OpenAPI specification: d-yoshi/redmine-openapi
- Code generation: Orval - TypeScript client and schema generator from OpenAPI