English Français العربية

Redmine

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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"
            }
        }
    }
}

متغيرات البيئة

  • REDMINE_SERVER إلزامي Base URL of your Redmine instance, e.g. https://redmine.example.com
  • REDMINE_API_KEY إلزامي سري Your Redmine API key (My account -> API access key)
  • REDMINE_MCP_ENABLE_WRITES Set to true to also register create/update/delete tools

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Redmine؟

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

كيف أثبّت Redmine؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Redmine إلى مفتاح API؟

نعم. يتطلب REDMINE_SERVER, REDMINE_API_KEY، وتضبطها في إعداداته.

هل Redmine مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Redmine؟

ينشره aarondpn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.