Redmine
Work with Redmine issues, projects, time entries, wiki pages and more. Read-only by default.
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: creates or changes data: records, files, settings.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.13.0
MCP client config
{
"mcpServers": {
"redmine": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/aarondpn/redmine-mcp:2.13.0"
]
}
}
}
redmine-cli
A command-line interface for Redmine project management.
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.
