Skip to main content
Glama
dokkiitech

redmine-mcp

by dokkiitech

redmine-mcp

An MCP server (stdio) for operating a self-hosted Redmine (redmine.dokkiitech.dev) from Claude Code.

Setup

Prerequisite: uv must be installed.

1. Issue a Redmine API key

  1. Log in to Redmine

  2. Click "My account" in the top right → "API access key" in the right sidebar → "Display"

  3. Note the displayed key

2. Register it with Claude Code

claude mcp add --scope user redmine \
  --env REDMINE_API_KEY=<自分のAPIキー> \
  -- uvx --from git+https://github.com/dokkiitech/redmine-mcp redmine-mcp

After registering, restart Claude Code and the redmine server will connect. Verify with claude mcp get redmine.

Related MCP server: Redmine MCP Server

Environment Variables

Variable

Required

Description

REDMINE_API_KEY

Redmine API access key (issue one per user)

REDMINE_URL

-

Connection destination (default: https://redmine.dokkiitech.dev)

Provided Tools

Tool

Description

list_projects

List projects

list_issues

List tickets (filter by project, status, assignee, and subject)

get_issue

Ticket details (including comment history and attachments)

create_issue

Create a ticket

update_issue

Update a ticket (add comments, change status, set progress, etc.)

search

Full-text search (tickets, Wiki, news, etc.)

list_metadata

List IDs for trackers / statuses / priorities / users

Notes

  • The Redmine server (EC2) is stopped between 0:00 and 12:00 JST. If you get a connection error, check whether it is during operating hours (12:00–24:00 JST).

  • The Redmine REST API silently ignores invalid values (such as a nonexistent custom field ID) without raising an error. After update operations, it is safest to re-read the ticket with get_issue and confirm the changes were applied.

Updating

uvx caches git repositories. To pull in a new version:

uv cache clean redmine-mcp

Development

git clone https://github.com/dokkiitech/redmine-mcp
cd redmine-mcp
REDMINE_API_KEY=<key> uv run redmine-mcp  # stdio で起動(Ctrl+C で終了)

License

MIT

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that enables Claude Code to directly interact with Redmine project management systems, supporting issue management, project operations, and search features.
    22
    9
    MIT
  • A
    license
    C
    quality
    D
    maintenance
    Model Context Protocol (MCP) server for Redmine that provides comprehensive access to the Redmine REST API, enabling users to operate Redmine from MCP clients such as Claude Desktop.
    90
    20
    MIT
  • A
    license
    C
    quality
    A
    maintenance
    Model Context Protocol (MCP) server for Redmine that provides comprehensive access to the Redmine REST API. It allows you to operate Redmine from MCP clients such as Claude Desktop.
    90
    541
    26
    MIT