All shelves / MCP servers

Redmine

io.github.aarondpn/redmine-mcp · 52 stars · Go · MIT

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

Install

The repo has no one-line install. Follow its README.

Published as

Dockerghcr.io/aarondpn/redmine-mcp:2.13.0stdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

Name	Set as	What it is
`REDMINE_SERVER`Required	Env var	Base URL of your Redmine instance, e.g. https://redmine.example.com
`REDMINE_API_KEY`Required · Secret	Env var	Your Redmine API key (My account -> API access key)
`REDMINE_MCP_ENABLE_WRITES`Optional	Env var	Set to true to also register create/update/delete tools

Files

README.md

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:

Platform	Architecture	Download
Linux	x86_64	`redmine-cli-linux-amd64.tar.gz`
Linux	ARM64	`redmine-cli-linux-arm64.tar.gz`
macOS	Intel	`redmine-cli-darwin-amd64.tar.gz`
macOS	Apple Silicon	`redmine-cli-darwin-arm64.tar.gz`
Windows	x86_64	`redmine-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

Run redmine --help to see all available commands.

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:

Tool	One-line install
Any agent (skill)	`npx skills add aarondpn/redmine-cli`
Any MCP host	`redmine 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 CLI	`codex plugin marketplace add aarondpn/redmine-cli` then `/plugins` (install Redmine from the added marketplace)
Gemini CLI	`gemini 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.

Facts

Kind: MCP server
Repo: aarondpn/redmine-cli
Group: Uncategorized
Stars: 52
License: MIT
Language: Go
Last push: 2026-10-09
Forks: 10
MCP Registry: io.github.aarondpn/redmine-mcp
Homepage: redmine-cli.dev
Topics: cli, redmine, redmine-api, redmine-client, mcp-server, mcp, skills