Redmine MCP server
Commit Nov 11, 2026Lets an AI agent manage Redmine projects, issues, and time entries through typed MCP tools or CLI commands.
Also known as aarondpn/redmine-cli, redmine-cli
- Stars
- 63
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2.20.1
- Last commit
- Nov 11, 2026
- License
- MIT
What is Redmine MCP?
Redmine lets an AI agent manage Redmine projects, issues, and time entries through typed MCP tools or CLI commands.
Summary generated from the project's README
About Redmine MCP server
Managing Redmine projects and tracking work hours through an AI agent is possible with this tool. It provides a bridge between language models and Redmine instances, allowing users to handle issues, projects, and time entries via typed MCP tools or direct CLI commands. The server is designed to work with various MCP hosts and can be deployed locally or via Docker.
To use the server, you must configure your Redmine server address and API key. Developers can run the server using the redmine mcp serve command or through a Docker container by providing the REDMINE_SERVER and REDMINE_API_KEY environment variables. The MCP implementation is read-only by default, though it supports write-tool gating for more advanced configurations. It is compatible with Redmine versions 4.x through 7.x.
What you can do with it
- 1Automate issue managementAsk an AI agent to list or view specific project issues.
- 2Track project hoursUse the tool to log time entries directly into Redmine.
- 3Script project dataExtract specific issue details using JSON output and jq filtering.
Written from the project's README. Every use case is checked against a quote from it.
How to install Redmine MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Redmine MCP in Claude Code
$ claude mcp add --env 'REDMINE_API_KEY=<YOUR_REDMINE_API_KEY>' --env 'REDMINE_SERVER=<REDMINE_SERVER>' redmine-cli -- docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.20.1Install Redmine MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"redmine-cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/aarondpn/redmine-mcp:2.20.1"
],
"env": {
"REDMINE_API_KEY": "<YOUR_REDMINE_API_KEY>",
"REDMINE_SERVER": "<REDMINE_SERVER>"
}
}
}
}Install Redmine MCP in VS Code
.vscode/mcp.json
{
"servers": {
"redmine-cli": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/aarondpn/redmine-mcp:2.20.1"
],
"env": {
"REDMINE_API_KEY": "<YOUR_REDMINE_API_KEY>",
"REDMINE_SERVER": "<REDMINE_SERVER>"
}
}
}
}Install Redmine MCP in VS Code CLI
$ code --add-mcp '{"name":"redmine-cli","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/aarondpn/redmine-mcp:2.20.1"],"env":{"REDMINE_API_KEY":"<YOUR_REDMINE_API_KEY>","REDMINE_SERVER":"<REDMINE_SERVER>"}}'Install Redmine MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"redmine-cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/aarondpn/redmine-mcp:2.20.1"
],
"env": {
"REDMINE_API_KEY": "<YOUR_REDMINE_API_KEY>",
"REDMINE_SERVER": "<REDMINE_SERVER>"
}
}
}
}Install Redmine MCP in Codex
$ codex mcp add redmine-cli --env 'REDMINE_API_KEY=<YOUR_REDMINE_API_KEY>' --env 'REDMINE_SERVER=<REDMINE_SERVER>' -- docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.20.1Install Redmine MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.redmine-cli] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/aarondpn/redmine-mcp:2.20.1"] [mcp_servers.redmine-cli.env] REDMINE_API_KEY = "<YOUR_REDMINE_API_KEY>" REDMINE_SERVER = "<REDMINE_SERVER>"
Install Redmine MCP in Gemini CLI
$ gemini mcp add -s user -e 'REDMINE_API_KEY=<YOUR_REDMINE_API_KEY>' -e 'REDMINE_SERVER=<REDMINE_SERVER>' redmine-cli docker -- run -i --rm ghcr.io/aarondpn/redmine-mcp:2.20.1Install Redmine MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"redmine-cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/aarondpn/redmine-mcp:2.20.1"
],
"env": {
"REDMINE_API_KEY": "<YOUR_REDMINE_API_KEY>",
"REDMINE_SERVER": "<REDMINE_SERVER>"
}
}
}
}Configuration
REDMINE_API_KEYRequiredSecretYour Redmine API key (My account -> API access key)
REDMINE_SERVERRequiredBase URL of your Redmine instance, e.g. https://redmine.example.com
REDMINE_MCP_ENABLE_WRITESSet to true to also register create/update/delete tools
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableaarondpn/redmine-cli is public and reachablegithub.com/aarondpn/redmine-cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/aarondpn/redmine-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubInstallation
Homebrew (macOS, Linux):
brew install aarondpn/tap/redmine
Install script (macOS, Linux):
curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash
PowerShell (Windows):
irm https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.ps1 | iex
Or download a binary from GitHub Releases. Update with redmine update. More options: installation docs.
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:
| 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.
Redmine MCP questions
How do I add Redmine MCP to Claude Code?
Run claude mcp add --env 'REDMINE_API_KEY=<YOUR_REDMINE_API_KEY>' --env 'REDMINE_SERVER=<REDMINE_SERVER>' redmine-cli -- docker run -i --rm ghcr.io/aarondpn/redmine-mcp:2.20.1 in your terminal. Add --scope user to make it available in every project.
How do I add Redmine MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I connect an MCP host to Redmine?
Run redmine mcp serve and add the resulting server to your MCP host's configuration. Alternatively, run the Docker MCP image with REDMINE_SERVER and REDMINE_API_KEY set.
Can the MCP server modify Redmine issues by default?
No. The MCP server is read-only by default, and write tools must be explicitly gated with per-group or per-tool allow- and deny-lists.
How do I authenticate the Redmine CLI?
Run redmine auth login to configure your Redmine server and API key.
Which Redmine versions are supported?
The tool targets Redmine 4.x, 5.x, 6.x, and 7.x, and E2E tests run against 4.2, 5.1, 6.1, and 7.0.
How can I get JSON output from Redmine CLI commands?
Use the -o json flag to print machine-readable JSON, and -q/--jq <expression> to filter it.