redmine-cli
redmine-cli runs Redmine issues and time tracking from a terminal and exposes them to agents as a skill or MCP server
- 63 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The Redmine API key opens issues and time entries, and with writes enabled the agent can change them
- Install scripts run through `curl | bash`
Install
- Works in
Manual install
brew install aarondpn/tap/redmineThen run `redmine auth login` to set the server and API key.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The Redmine API key opens issues and time entries, and with writes enabled the agent can change them
- Install scripts run through `curl | bash`
This is third-party code. Review the repository files before installing.
What it does
redmine-cli is a Go command-line client for Redmine. Commands such as `redmine issues list`, `redmine issues view 123` and `redmine time log` work with issues and time entries, and JSON output with a built-in `--jq` filter suits scripts. Redmine 4.x to 7.x is supported. For agents the repository ships a skill in the `SKILL.md` format and an MCP server started with `redmine mcp serve`. The skill teaches the agent output formats, name resolution and pagination. The MCP server is read-only by default, writes are enabled with the `REDMINE_MCP_ENABLE_WRITES` variable, and per-group allow and deny lists exist.
Who it is for. Teams that run projects in Redmine and want to give an agent issues and time logging with control over writes.
Good fit when
- An agent in Claude Code has to find its open issues in a project and show statuses
- You need to log time on an issue from the terminal without opening the web interface
- A script collects issues through `--jq` and passes them on
- The server connects to Cursor or Zed in read-only mode
Not a fit when
- Redmine is not deployed and you have no API key
- A manager needs a graphical interface
- You need users and permissions that the Redmine API does not expose
Example request
Show my open issues in the web project and log two hours on issue 123Limitations
The Redmine server address and an API key are required, set with `redmine auth login` or the `REDMINE_SERVER` and `REDMINE_API_KEY` variables. Without the write flag the MCP server does not change data, and with writes on the agent has the same rights as the key owner, so a separate Redmine user with trimmed roles is better for an agent. The install script runs through `curl | bash`, so read it before running.
How to disable. Uninstall the package (`brew uninstall redmine`), remove the skill and delete the server entry from the client configuration. The API key can be revoked in the Redmine profile.
FAQ
How do I connect redmine-cli to an agent?
The skill works with any agent: `npx skills add aarondpn/redmine-cli`. For MCP clients run `redmine mcp serve` and add the command to the configuration. Claude Code also has `/plugin marketplace add aarondpn/redmine-cli`.
Can the agent change issues?
Only if writes are enabled. The MCP server reads by default and writes are opened by the `REDMINE_MCP_ENABLE_WRITES` variable.
How is it different from other Redmine MCP servers?
It is a standalone console for people and scripts, and the MCP server and skill are built on the same commands. The server also runs in Docker from the `ghcr.io/aarondpn/redmine-mcp` image.
Which Redmine versions are supported?
Versions 4.x, 5.x, 6.x and 7.x are listed. Check your server against the compatibility table in the documentation.
How do I get data for a script?
Add `-o json` and the `--jq` filter, for example `redmine issues get 123 --jq '.status.name'`. In JSON mode errors go to stderr as one line and the exit code is non-zero.
Discussion
No questions or reviews yet.
Related
CLI toolsMCP Redmine restricts files to approved directories, and administrators can limit read-only work to GET requests.
Redmine MCP Server: issues and time tracking
Redmine MCP Server
An MCP server for Redmine: issues, projects, wikis, time tracking and files, a read-only mode and per-user OAuth2 sign-in
A Redmine plugin with AI chat, issue summaries and an MCP server: an external agent works with Redmine issues via an API key.
Jira MCP in Go: an agent searches issues by JQL, runs sprints, comments and worklogs and sees an issue's branches and pull requests on Cloud and Server
Jira CLI displays issues and sprints as tables or script data, keeping work-item queries in the terminal beside source code.
A self-hosted issue tracker and wiki on Cloudflare with MCP: 126 tools, issue leases and file claims for several agents
README in short
The README starts with installation through Homebrew, a script and binary releases, then first commands and JSON output. A separate section lists the ways to connect agents and links to a detailed guide.