Mcp For Redmine

by chspower1

270 downloads
Not rated
GitHub

About

This project is a Model-Context-Protocol (MCP) server for interacting with Redmine. With an MCP-compatible client, you can easily manage Redmine projects, issues, users, and time entries.

Details

Author
chspower1
Downloads
270
Categories
Other, Project Management

- Manage users: create, get, list, update, delete.
- Manage projects: CRUD plus archive/unarchive operations.
- Manage issues: full CRUD with support for custom fields and attachments.
- Manage time entries: list, get, create, update, delete.
- Alpha APIs for memberships, versions, wiki pages, queries, files, attachments, issue relations, and more.
- Pagination and association expansion on list tools.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp For Redmine
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install and configure the server by adding it as an MCP server in your client (Cursor, Claude Desktop, Claude Code, Gemini CLI, or OpenAI Codex). Provide your Redmine base URL and API key via environment variables (REDMINE_BASE_URL and REDMINE_API_KEY) or CLI flags (--url, --api-key). The server runs via npx -y @chspower1/mcp-for-redmine@latest using stdio transport.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp for redmine": {
            "mcp-for-redmine": {
                "command": "npx",
                "args": [
                    "-y",
                    "@chspower1/mcp-for-redmine@latest"
                ],
                "env": {
                    "REDMINE_BASE_URL": "https://your.redmine.tld",
                    "REDMINE_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "mcp-for-redmine": {
        "command": "npx",
        "args": [
            "-y",
            "@chspower1/mcp-for-redmine@latest"
        ],
        "env": {
            "REDMINE_BASE_URL": "https://your.redmine.tld",
            "REDMINE_API_KEY": "your_api_key_here"
        }
    }
}

MCP-For-Redmine · MIT License

English | 한국어 | 日本語 | 简体中文

This project is a Model-Context-Protocol (MCP) server for interacting with Redmine. With an MCP-compatible client, you can easily manage Redmine projects, issues, users, and time entries.

Currently, only the standard input/output (stdio) transport is supported.

Requirements

- Node.js 18 or higher
- Redmine API key (your personal API key from your Redmine account)

Compatibility baseline: Redmine 6.0.6

Getting Started

How to configure the MCP server for each environment:

<details>
<summary><b>Cursor</b></summary>

File (top-left) -> Preferences -> Cursor Settings -> MCP & Integrations -> New MCP Server

<b>Config file</b>: ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project)

📚 <b>Docs</b>: Cursor MCP documentation

Install MCP Server

{
  "mcpServers": {
    "mcp-for-redmine": {
      "command": "npx",
      "args": ["-y", "@chspower1/mcp-for-redmine@latest"],
      "env": {
        "REDMINE_BASE_URL": "https://your.redmine.tld",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

</details>

<details>
<summary><b>Claude Desktop</b></summary>

<b>Config files</b>:

- <b>Windows</b>: %APPDATA%\Claude\claude_desktop_config.json
- <b>macOS</b>: ~/Library/Application Support/Claude/claude_desktop_config.json

📚 <b>Docs</b>: Claude Desktop MCP guide

{
  "mcpServers": {
    "mcp-for-redmine": {
      "command": "npx",
      "args": ["-y", "@chspower1/mcp-for-redmine@latest"],
      "env": {
        "REDMINE_BASE_URL": "https://your.redmine.tld",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

</details>

<details>
<summary><b>Claude Code</b></summary>

📚 <b>Docs</b>: Claude Code MCP documentation

<b>Set environment variables and run CLI</b>:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.