Redmine MCP Server

Exposes Redmine REST API as tools for Claude Code via MCP (Model Context Protocol).

Available tools

Tool	Description
Issues

Tool	Description
`create_issue`	Create a new issue (supports subtask, watchers, relations)
`get_issue`	Get issue details by ID
`list_issues`	Query issues with filters (project, status, assignee)
`update_issue`	Update title, description, priority, due date, subtask, watchers, relations
`update_issue_status`	Change issue status
`update_issue_progress`	Set % done (0–100)

Comments & members

Tool	Description
`get_issue_comments`	Get all comments and field changes
`add_issue_comment`	Post a new comment
`assign_issue`	Assign issue to a user
`get_project_members`	List project members with user IDs
`get_issue_statuses`	List all available statuses (use to find status IDs)

Relations & watchers

Tool	Description
`get_issue_relations`	List all relations for an issue
`add_issue_relation`	Add a relation between two issues
`remove_issue_relation`	Remove a relation by relation ID
`add_watcher`	Add a watcher to an issue
`remove_watcher`	Remove a watcher from an issue

Search

Tool	Description
`search`	Search by keyword across issues, wiki, news, documents, and more

Setup

1. Get your Redmine API key

Log in to your Redmine instance
Go to My account (top-right avatar menu)
Scroll to API access key on the right side
Click Show — copy the key

2. Configure environment

cp .env.example .env

Edit .env:

REDMINE_URL=https://your.redmine.com
REDMINE_API_KEY=your_personal_api_key_here

3. Run the container

The image is published automatically to ghcr.io/shadoll/redmine-mcp:latest on every push to main.

docker compose up -d
# or with podman:
podman-compose up -d

The server will be available at http://localhost:8765.

4. Register with Claude Code

claude mcp add --scope user --transport http redmine http://localhost:8765/mcp

Verify it was added:

claude mcp list

Usage examples

Once registered, just ask Claude naturally in any project:

"Create a new issue in project api-service: Fix login timeout" "Get issue #1234" "Search for issues related to login bug" "Change status of issue #1234 to In Progress" "Add a comment to issue #1234: deployment done" "Who is assigned to issue #1234?" "List open issues in project api-service assigned to me"

2.6 KiB Raw Blame History Unescape Escape