RedmineMCP MCP Server

An integration between Claude AI (or any MCP client - Like Windsurf) and Redmine using the Model Context Protocol (MCP).

Local serverstdioTypeScript

What is the RedmineMCP MCP Server?

An integration between Claude AI (or any MCP client - Like Windsurf) and Redmine using the Model Context Protocol (MCP).

What RedmineMCP does

You can use the existing tooling like Jira MCP servers to accomplish this. We disagree with Jira's structure and design as Redmine allows entire Projects to be shifted or rehomed without issue. If you want an 100% OpenSource solution, keep reading.

Key capabilities

  • Project Management — List and view Redmine projects with detailed information
  • Issue Tracking — Create, update, list and view issues with full parameter support
  • Parent-Child Relationships — Create and manage subtasks with hierarchical structure
  • Issue Relations — Create, view, and manage issue relationships (relates, blocks, etc.)
  • User Information — Access current user details and permissions
  • Robust Error Handling — Detailed error reporting and parameter validation
  • Mock Mode — Development and testing without requiring a Redmine instance

Practical notes

  • Maintained by zacharyelston, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the RedmineMCP MCP Server

{
  "mcpServers": {
    "redmine": {
      "command": "node",
      "args": ["/absolute/path/to/redmcp-typescript/build/index.js"],
      "env": {
        "REDMINE_URL": "http://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
REDMINE_URLEndpoint or connection string the server talks to.Yes
REDMINE_API_KEYCredential the server authenticates with.Yes
LOG_LEVELConfiguration value read at startup.Optional
GITLAB_URLEndpoint or connection string the server talks to.Yes
GITLAB_TOKENCredential the server authenticates with.Yes
GITLAB_PROJECT_IDConfiguration value read at startup.Optional
SYNC_GITHUB_TOKENCredential the server authenticates with.Yes

Frequently asked questions

An integration between Claude AI (or any MCP client - Like Windsurf) and Redmine using the Model Context Protocol (MCP). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.