# Redmine

Connect an AI agent to Redmine to inspect issues, projects, time entries, and wiki pages. The server starts in read-only mode.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 56
- Author: aarondpn
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aarondpn/redmine-cli
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/redmine

## What it does

The server gives an agent typed tool calls for working with Redmine. Ask it to find project issues, inspect a particular issue, review time entries, or look up a wiki page. Other Redmine operations are available too.

Setup requires a Redmine server address and an API key, passed through `REDMINE_SERVER` and `REDMINE_API_KEY`. Writes are off by default; `REDMINE_MCP_ENABLE_WRITES` controls access to write operations. Enabling that setting lets the agent change Redmine data, so check it before connecting. In Claude Code, the server runs in Docker over `stdio`.

## Requirements
- Needs: Docker
- Environment variables: `REDMINE_SERVER`, `REDMINE_API_KEY`, `REDMINE_MCP_ENABLE_WRITES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env REDMINE_SERVER=<REDMINE_SERVER> --env REDMINE_API_KEY=<REDMINE_API_KEY> --env REDMINE_MCP_ENABLE_WRITES=<REDMINE_MCP_ENABLE_WRITES> --transport stdio redmine -- docker run -i --rm -e REDMINE_SERVER -e REDMINE_API_KEY -e REDMINE_MCP_ENABLE_WRITES ghcr.io/aarondpn/redmine-mcp:2.14.1
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add redmine --env REDMINE_SERVER=<REDMINE_SERVER> --env REDMINE_API_KEY=<REDMINE_API_KEY> --env REDMINE_MCP_ENABLE_WRITES=<REDMINE_MCP_ENABLE_WRITES> -- docker run -i --rm -e REDMINE_SERVER -e REDMINE_API_KEY -e REDMINE_MCP_ENABLE_WRITES ghcr.io/aarondpn/redmine-mcp:2.14.1
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "redmine": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "REDMINE_SERVER",
                "-e",
                "REDMINE_API_KEY",
                "-e",
                "REDMINE_MCP_ENABLE_WRITES",
                "ghcr.io/aarondpn/redmine-mcp:2.14.1"
            ],
            "env": {
                "REDMINE_SERVER": "<REDMINE_SERVER>",
                "REDMINE_API_KEY": "<REDMINE_API_KEY>",
                "REDMINE_MCP_ENABLE_WRITES": "<REDMINE_MCP_ENABLE_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "redmine": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "REDMINE_SERVER",
                "-e",
                "REDMINE_API_KEY",
                "-e",
                "REDMINE_MCP_ENABLE_WRITES",
                "ghcr.io/aarondpn/redmine-mcp:2.14.1"
            ],
            "env": {
                "REDMINE_SERVER": "<REDMINE_SERVER>",
                "REDMINE_API_KEY": "<REDMINE_API_KEY>",
                "REDMINE_MCP_ENABLE_WRITES": "<REDMINE_MCP_ENABLE_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REDMINE_SERVER=<REDMINE_SERVER> -e REDMINE_API_KEY=<REDMINE_API_KEY> -e REDMINE_MCP_ENABLE_WRITES=<REDMINE_MCP_ENABLE_WRITES> redmine docker run -i --rm -e REDMINE_SERVER -e REDMINE_API_KEY -e REDMINE_MCP_ENABLE_WRITES ghcr.io/aarondpn/redmine-mcp:2.14.1
```
Replace <…> with your own values

## When to use it
- find issues in a Redmine project
- inspect an issue by its number
- review logged time entries
- look up a wiki page

## Example prompts
- Find the open issues in project `myproject` and list their IDs.
- Show issue `123` and report its status.
- Find the project's time entries and summarize them.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md