Redmine CLI, developed by Aarondpn, is a Go-based command-line tool designed for interacting with Redmine servers. It provides a direct interface for managing project data and issue tracking from the terminal. Beyond individual use, Redmine CLI also functions as an MCP server, enabling AI agents to automate workflows and interact with Redmine. This utility supports various operating systems through pre-compiled binaries, Homebrew, an install script, or Go toolchain installation, offering flexibility for different user environments.

What does Redmine CLI connect to?

Redmine CLI connects to a Redmine server, which is a web-based system for project management and issue tracking. It serves as a command-line interface for these functions. Additionally, Redmine CLI operates as an MCP (Model Context Protocol) server. This dual functionality allows it to not only provide direct terminal access for users but also to integrate with AI agents, extending its utility into automated project management and data interaction within the Redmine ecosystem.

Core features and tools

Redmine CLI exposes many tools for managing Redmine. Key commands include redmine auth for login, redmine issues for issue lifecycle control, and redmine time for managing time entries. Users can manage projects with redmine projects, inspect attachments via redmine attachments, and handle versions using redmine versions. Additional tools cover redmine files, redmine memberships, redmine users, redmine my-account, redmine groups, redmine roles, redmine categories, redmine trackers, redmine statuses, redmine search, redmine wiki, and redmine api. It also features redmine mcp serve and redmine update.

Who is it for?

Redmine CLI is intended for individual users, developers, and administrators who prefer interacting with Redmine via the command line. It also serves AI agents for automating various project management tasks. Its capabilities extend to those seeking to integrate Redmine with AI-driven workflows, supporting clients like Claude Code, Codex CLI, and Gemini CLI. Skip this if you prefer graphical interfaces exclusively for all Redmine interactions.

How to get started

The server authenticates using Redmine API keys or username/password. This process creates a profile stored in ~/.redmine-cli.yaml.

Use cases

• Issue Management: Users create, list, view, update, and close Redmine issues efficiently from the terminal, for example, "redmine issues list --assignee me" to view assigned tasks.
• Time Tracking: The tool allows logging and managing time entries against specific issues, such as "redmine time log --issue 123 --hours 2.5 --activity Development --comment 'Code review'".
• AI Agent Integration: It enables AI agents to interact with Redmine for automated issue creation, summarization, or project updates by running the built-in MCP server.

Redmine CLI offers a powerful command-line interface for Redmine, supporting a full range of project management and issue tracking operations. Its built-in MCP server extends its utility significantly, allowing AI agents to automate and interact with Redmine data. This makes it a valuable tool for both direct user interaction and advanced automated workflows. Try listing your assigned issues using "redmine issues list --assignee me" to explore its capabilities.