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

Provided Tools

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