English Français العربية

Redmine

Official registry Other

Work with Redmine issues, projects, time entries, wiki pages and more. Read-only by default.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/aarondpn/redmine-mcp:2.15.0
Claude Code 
claude mcp add redmine -e 'REDMINE_SERVER=<REDMINE_SERVER>' -e 'REDMINE_API_KEY=<your redmine_api_key>' -e 'REDMINE_MCP_ENABLE_WRITES=false' -- docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.15.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "redmine": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/aarondpn/redmine-mcp:2.15.0"
            ],
            "env": {
                "REDMINE_SERVER": "<REDMINE_SERVER>",
                "REDMINE_API_KEY": "<your redmine_api_key>",
                "REDMINE_MCP_ENABLE_WRITES": "false"
            }
        }
    }
}

Environment variables

  • REDMINE_SERVER required Base URL of your Redmine instance, e.g. https://redmine.example.com
  • REDMINE_API_KEY required secret Your Redmine API key (My account -> API access key)
  • REDMINE_MCP_ENABLE_WRITES Set to true to also register create/update/delete tools

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. redmine-cli
  2. Installation
  3. Getting Started
  4. Using with AI Agents
  5. Development

redmine-cli

A command-line interface for Redmine project management.

English · 简体中文 · 日本語

Installation · Getting Started · AI Agents

Installation

Homebrew (macOS & Linux)
brew tap aarondpn/tap
brew install redmine

This also installs shell completions for bash, zsh, and fish.

Quick Install Script
curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash

Auto-detects your OS and architecture, downloads the latest release with checksum verification, and installs to ~/.local/bin.

Install with Go
go install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest
Manual Download

Grab the latest release for your platform from GitHub Releases:

PlatformArchitectureDownload
Linuxx86_64redmine-cli-linux-amd64.tar.gz
LinuxARM64redmine-cli-linux-arm64.tar.gz
macOSIntelredmine-cli-darwin-amd64.tar.gz
macOSApple Siliconredmine-cli-darwin-arm64.tar.gz
Windowsx86_64redmine-cli-windows-amd64.zip
Updating
redmine update

Downloads and verifies the latest release via SHA256 checksum before replacing the binary.

Getting Started

# Configure your Redmine server and API key
redmine auth login

# List issues
redmine issues list

# View a specific issue
redmine issues view 123

# Log time
redmine time log

# Script it: JSON output filtered with the built-in --jq
redmine issues list --project myproject --jq '.[].id'
redmine issues get 123 --jq '.status.name'

Run redmine --help to see all available commands.

-o json prints machine-readable JSON, and -q/--jq <expression> filters it (strings are printed raw, everything else as JSON). Errors always go to stderr; in JSON mode they are a single-line {"error": {...}} envelope on the last line of stderr, stdout stays empty and the exit code is non-zero. See Output formats.

Using with AI Agents

redmine-cli ships an Agent Skill (the open SKILL.md standard, supported by 35+ agents) and a built-in MCP server. Both are vendor-neutral - pick the one-liner that matches your tool:

ToolOne-line install
Any agent (skill)npx skills add aarondpn/redmine-cli
Any MCP hostredmine mcp serve (then add to host config)
Docker (MCP only)docker run -i --rm -e REDMINE_SERVER -e REDMINE_API_KEY ghcr.io/aarondpn/redmine-mcp
Claude Code/plugin marketplace add aarondpn/redmine-cli then /plugin install redmine
Codex CLIcodex plugin marketplace add aarondpn/redmine-cli then /plugins (install Redmine from the added marketplace)
Gemini CLIgemini extensions install https://github.com/aarondpn/redmine-cli

The skill teaches the agent the non-obvious parts of the CLI (output formats, name resolution, pagination, common workflows). The MCP server exposes the same operations as typed tool calls, read-only by default, with per-group / per-tool allow- and deny-lists.

Full configuration, host-specific snippets (Claude Desktop, Cursor, Zed, VS Code), and write-tool gating: see the AI Agent Integration guide.

Development

Local E2E testing against a real Redmine instance (Docker, supported on Redmine 4.2, 5.1, 6.1, 7.0): see e2e/README.md.

Frequently asked questions

What is Redmine?

Work with Redmine issues, projects, time entries, wiki pages and more. Read-only by default.

How do I install Redmine?

It runs on your machine. In Claude Code: claude mcp add redmine -e 'REDMINE_SERVER=<REDMINE_SERVER>' -e 'REDMINE_API_KEY=<your redmine_api_key>' -e 'REDMINE_MCP_ENABLE_WRITES=false' -- docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.15.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Redmine need an API key?

Yes. It expects REDMINE_SERVER, REDMINE_API_KEY, which you set in its configuration.

Is Redmine open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Redmine?

It is published by aarondpn. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.