RedmineのMCPサーバー シンプルな自然言語コマンドでAIエージェントが問題に取り組むことを可能にします。

単一の開発者のための個人的なツールだけでなく、単独の開発者のために機能するか、一度デプロイして共有する チーム全体

お問い合わせ

「どんな問題が私に割り当てられますか? 優先的に並べ替えます。

「Webプロジェクトでバグを作成する:ログインボタンがモバイルで応答せず、緊急にマークします。」

「問題#456とそのサブタスクをまとめる」

「この週に何時間もログアウトしたのか」

要件

• Node.js 22 +
• REST API が有効な Redmine インスタンス ( Administration → Settings → API )
• Redmine API キー — サインイン時に、My アカウント → API アクセスキー に移動します。

クイックスタート

ほとんどのMCPクライアント(Claude Desktopなど)がサーバーを起動し、一度設定して忘れてください。

Claudeデスクトップの場合、これは[claude_desktop_config.json]に移動します(設定 → 開発者 → 編集 Config です。 クライアントを再起動し、Redmineツールがツールリストに表示されます。

シェルからスタンドアローンを実行する代わりに:

サーバは stdio で MCP を話し、 stderr にログを記録するので、 stdout はプロトコルをクリーンに保ちます。

設定

環境変数で設定し、起動時に検証します。 .env を参照してください.

🦎 Agama — Redmine MCP Server

MCP server for Redmine. Enables AI agents to work with issues using simple natural language commands.

Works just as well as a personal tool for a single developer — or deployed once and shared by the whole team.

┌──────────┐   MCP (stdio)   ┌─────────────────────┐   REST/JSON   ┌──────────┐
│  Agent   │ ──────────────▶ │  Redmine MCP Server │ ────────────▶ │ Redmine  │
│ (client) │ ◀────────────── │   (this project)    │ ◀──────────── │  server  │
└──────────┘   tool results  └─────────────────────┘     HTTP      └──────────┘

💬 Just ask

“What issues are assigned to me? Sort them by priority.”

“Create a bug in the Web project: login button doesn’t respond on mobile, mark it urgent.”

“Summarize issue #456 and all its subtasks.”

“How many hours did I log this week, broken down by project?”

Requirements

• Node.js 22+
• A Redmine instance with the REST API enabled (Administration → Settings → API)
• A Redmine API key — go to My account → API access key while signed in

Quick start

Most MCP clients (e.g. Claude Desktop) launch the server for you — configure it once and forget it:

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "@0xkillaflow/agama-redmine-mcp"],
      "env": {
        "REDMINE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your-redmine-api-key"
      }
    }
  }
}

For Claude Desktop, this goes in claude_desktop_config.json (Settings → Developer → Edit Config). Restart the client and the Redmine tools will appear in its tool list.

To run it standalone from a shell instead:

REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=your-redmine-api-key \
  npx -y @0xkillaflow/agama-redmine-mcp

The server speaks MCP over stdio and logs to stderr, so stdout stays clean for the protocol.

Configuration

Set via environment variables, validated at startup. See .env.example for a