Skip to main content
Glama
redmine-mcp-server

redmine-mcp-server

by xukaaaa

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-mcp

Or 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

  1. Log in to your Redmine instance

  2. Go to My Account (top right)

  3. Find API access key on the right sidebar

  4. 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_my_tasks

List tasks assigned to you (filter: open/closed/status name)

get_issue_details

Get detailed info about a specific issue

log_time

Log time entry with hours and comment

update_issue_status

Change issue status

update_progress

Update completion percentage

add_note

Add a comment to an issue

get_today_logs

View today's time entries and total hours

get_time_logs_range

View time logs within a date range (from_date, to_date)

clear_cache

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-server

License

MIT License - see LICENSE for details.

Author

xukaaaa - GitHub

Available Tools

9 tools
add_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

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    With 9 tools, the server is well-scoped for Redmine task management. Each tool serves a specific need without excessive length or sparse coverage.

    Completeness2/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      33
      499 npm
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Redmine project management systems through MCP tools, providing access to issues, projects, time tracking, wiki, and more.
      607 PyPI
      92
      MIT