redmine-mcp-server
Provides tools for managing Redmine tasks, including listing tasks, logging time, updating status, progress, and adding notes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@redmine-mcp-server Show me my open tasks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Redmine MCP Server
MCP (Model Context Protocol) Server for Redmine - Manage tasks, log time, update status via Claude/AI assistants.
Features
List Tasks - View tasks assigned to you with status filtering
Task Details - Get detailed information about specific issues
Log Time - Record time entries with comments
Update Status - Change issue status (in progress, resolved, etc.)
Update Progress - Set completion percentage (0-100%)
Add Notes - Add comments to issues
Daily Summary - Check today's logged hours
Time Logs Range - View logged hours within a date range
Related MCP server: Redmine MCP Server
Installation
pip install xukaaaa-redmine-mcpOr install from source:
git clone https://github.com/xukaaaa/redmine-mcp-server.git
cd redmine-mcp-server
pip install -e .Configuration
Set the following environment variables:
export REDMINE_URL="https://your-redmine-instance.com"
export REDMINE_API_KEY="your-api-key"Getting your Redmine API Key
Log in to your Redmine instance
Go to My Account (top right)
Find API access key on the right sidebar
Click Show or Reset to get your key
Usage with Claude Desktop
Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"redmine": {
"command": "redmine-mcp-server",
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key"
}
}
}
}Available Tools
Tool | Description |
| List tasks assigned to you (filter: open/closed/status name) |
| Get detailed info about a specific issue |
| Log time entry with hours and comment |
| Change issue status |
| Update completion percentage |
| Add a comment to an issue |
| View today's time entries and total hours |
| View time logs within a date range (from_date, to_date) |
| Clear cached metadata |
Examples
Ask Claude:
"Show me my open tasks"
"What's the status of issue #123?"
"Log 2 hours on task #456 for code review"
"Mark issue #789 as resolved"
"Update task #101 to 80% complete"
"How many hours have I logged today?"
"Show me my time logs from 2025-12-23 to 2025-12-27"
Development
# Clone the repo
git clone https://github.com/xukaaaa/redmine-mcp-server.git
cd redmine-mcp-server
# Install in development mode
pip install -e .
# Run the server
redmine-mcp-serverLicense
MIT License - see LICENSE for details.
Author
xukaaaa - GitHub
Available Tools
9 toolsadd_noteB
Thêm comment (note) vào task
Inputs: issue_id (required), note (required). Returns: result
clear_cacheB
Xóa cache để reload metadata từ Redmine
Inputs: no named parameters. Returns: result
get_issue_detailsB
Xem chi tiết một task cụ thể bằng ID.
Inputs: issue_id (required). Returns: result
get_time_logs_rangeB
Xem tổng giờ đã log trong khoảng thời gian. Args: from_date: Ngày bắt đầu (YYYY-MM-DD) to_date: Ngày kết thúc (YYYY-MM-DD)
Inputs: from_date (required), to_date (required). Returns: result
get_today_logsA
Kiểm tra tổng giờ đã log trong hôm nay
Inputs: no named parameters. Returns: result
list_my_tasksB
Lấy danh sách task được assign cho tôi. Args: status_filter: Trạng thái task (open, closed, hoặc tên status cụ thể like 'in_progress'). Default: open.
Inputs: status_filter. Returns: result
log_timeB
Log thời gian làm việc vào task với đầy đủ parameters. Args: issue_id: ID của task hours: Số giờ (ví dụ 1.5) comment: Mô tả công việc đã làm activity_id: ID của activity (ví dụ: 14 cho Development). Default: từ cache spent_on: Ngày làm việc (YYYY-MM-DD). Default: today custom_fields: Custom fields dạng JSON string (ví dụ: '[{"id": 64, "value": "Coding"}]')
Inputs: issue_id (required), hours (required), comment (required), activity_id, +2 more. Returns: result
update_issue_statusA
Cập nhật trạng thái của task. Args: issue_id: ID của task status_name: Tên trạng thái (ví dụ: 'resolved', 'in progress', 'completed') act_start: Ngày bắt đầu thực tế (YYYY-MM-DD). Bắt buộc khi status=completed. Default: today act_finish: Ngày kết thúc thực tế (YYYY-MM-DD). Bắt buộc khi status=completed. Default: today
Inputs: issue_id (required), status_name (required), act_start, act_finish. Returns: result
update_progressA
Cập nhật % hoàn thành (0-100)
Inputs: issue_id (required), percent (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: adding notes, clearing cache, viewing issue details, querying time logs, logging time, listing tasks, updating status, updating progress. No overlaps.
All tool names follow a consistent snake_case verb_noun pattern (e.g., list_my_tasks, get_issue_details, update_issue_status). The naming is uniform and predictable.
With 9 tools, the server is well-scoped for Redmine task management. Each tool serves a specific need without excessive length or sparse coverage.
The tool set lacks issue creation and deletion, which are fundamental for full lifecycle management. Users cannot create new tasks, only update or view existing ones, limiting agent capabilities.
Maintenance
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project management shared by people and AI agents, with persistent project state through MCP.
Project tracker for AI agents and teams: file, claim, update and hand off tickets over MCP.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI assistants to interact with Redmine project management systems, providing comprehensive access to issues, projects, time tracking, users, and wiki pages through natural language commands.33499 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI applications to interact with Redmine project management systems for issue tracking, time logging, and project management through natural language.12 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Redmine project management systems through MCP tools, providing access to issues, projects, time tracking, wiki, and more.607 PyPI92MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3362 npm6Apache 2.0