home / mcp / redmine mcp server

Redmine MCP Server

Provides access to Redmine projects and issues through MCP actions like reading project details and creating issues.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ilask-redmine-mcp": {
      "command": "node",
      "args": [
        "C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"
      ],
      "env": {
        "REDMINE_HOST": "https://redmine.example.com",
        "REDMINE_API_KEY": "your_redmine_api_key"
      }
    }
  }
}

You connect Redmine with the Cline MCP system to manage Redmine projects and issues directly from your editor. This MCP server lets you read project details and create issues without leaving your development environment, streamlining project management tasks alongside your code.

How to use

After you add the Redmine MCP server to your MCP client, you can access Redmine resources and run tools to interact with your projects. Use the access_mcp_resource tool to read a project’s details, for example to fetch information about a specific Redmine project. You can also create new issues in Redmine by invoking the create_issue tool and providing the project ID, subject, and description. These actions enable you to manage issues and project data as part of your normal coding workflow.

Typical usage patterns include selecting a Redmine project resource to inspect its details, then creating issues to track work directly from your editor. You can chain resource reads and issue creation to quickly translate coding tasks into Redmine tickets, helping your team stay aligned on progress and scope.

How to install

Prerequisites and steps you need to set up the Redmine MCP server locally and prepare it for use.

# Prerequisites
node -v   # should be v18 or newer
npm -v

# 1. Clone the MCP server repository
git clone https://github.com/ilask/Redmine-MCP.git
cd Redmine-MCP

# 2. Install dependencies
npm install

# 3. Create environment configuration
# Create a .env file in the project root with your Redmine host and API key
# REDMINE_HOST=your-redmine-host.com
# REDMINE_API_KEY=your-redmine-api-key
```} ,{

Configuration and running the server

Configure the MCP client to run the Redmine MCP server. The server runs as a local process started by the MCP client using a stdio command. The exact command and path to the server script are shown below.

{
  "mcpServers": {
    "redmine_mcp": {
      "command": "node",
      "args": ["C:\\Users\\yourusername\\path\\to\\Redmine-MCP\\server.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
````} ,{

Troubleshooting

If you encounter a connection issue, verify that you correctly configured the Redmine host and API key in the environment and that your Redmine instance is accessible from your machine.

Check the MCP server logs in the editor terminal for error messages to identify misconfigurations or network problems.

Notes and security

Environment variables REDMINE_HOST and REDMINE_API_KEY are required for the server to connect to Redmine. Keep your API key secure and do not commit the .env file to version control.

Available tools

access_mcp_resource

Reads details of a specified MCP resource, such as a Redmine project, via the MCP server.

create_issue

Creates a new Redmine issue in a given project by providing the project_id, subject, and description.