Skip to content
Conduit

mcp server

redmine-cli

A powerful command-line interface for Redmine, enhanced with first-class AI agent capabilities via Skills and MCP integration.

aarondpn/redmine-clicommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Docker Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "redmine-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDMINE_SERVER",
        "-e",
        "REDMINE_API_KEY",
        "-e",
        "REDMINE_MCP_ENABLE_WRITES",
        "ghcr.io/aarondpn/redmine-mcp:2.14.0"
      ],
      "env": {
        "REDMINE_SERVER": "<your REDMINE_SERVER>",
        "REDMINE_API_KEY": "<your REDMINE_API_KEY>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

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.

↑↓ navigate openesc close