English Français العربية

Redmine

Registre officiel Autres

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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"
            }
        }
    }
}

Variables d'environnement

  • REDMINE_SERVER obligatoire Base URL of your Redmine instance, e.g. https://redmine.example.com
  • REDMINE_API_KEY obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que Redmine ?

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

Comment installer Redmine ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Redmine ?

Oui. Il attend REDMINE_SERVER, REDMINE_API_KEY, à renseigner dans sa configuration.

Redmine est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Redmine ?

Il est publié par aarondpn. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.