Redmine MCP Server

Name: Redmine MCP Server
Author: yonaka15

@yonaka15

Repository

About Redmine MCP Server

MCP server for Redmine

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-redmine": {
      "command": "npx",
      "args": [
        "-y",
        "--prefix",
        "/path/to/mcp-server-redmine",
        "mcp-server-redmine"
      ],
      "env": {
        "REDMINE_HOST": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Redmine MCP Server?

Redmine MCP Server is a Model Context Protocol (MCP) server implementation that integrates with Redmine's REST API to provide ticket and project information to LLMs. It is designed for users who want to manage Redmine issues, projects, users, and time entries through AI assistants.

How to use Redmine MCP Server?

Configure the server in your MCP client (e.g., Claude) with the command npx -y --prefix /path/to/mcp-server-redmine mcp-server-redmine and set the REDMINE_HOST and REDMINE_API_KEY environment variables. The API key must be obtained from Redmine user settings after enabling the REST API in Redmine admin settings.

Key features of Redmine MCP Server

Supports Redmine Issues, Projects, Users, and Time Entries resources
Search, create, update, and delete operations for issues
Project management with archive/unarchive capabilities
Custom field support for issues and time entries
Time entry filtering by project, user, and date range
Keyword search across issues and projects

Use cases of Redmine MCP Server

Query and manage Redmine issues through natural language conversations
Create, update, and track project progress via an LLM interface
Record and retrieve time entries against projects or issues
Manage users and their permissions (with admin privileges)
Search and filter Redmine data without using the web interface

FAQ from Redmine MCP Server

What permissions are required?

Some operations like list_users, create_user, update_user, delete_user require administrator privileges. Available information varies based on user permission levels in Redmine.

What are the runtime requirements?

Node.js 18 or higher and npm 9 or higher are required. The server uses the @modelcontextprotocol/sdk, zod, and typescript libraries.

How do I get an API key?

Enable the REST API in Redmine admin settings, then obtain your API key from your Redmine user settings page.

What transports are supported?

—

How are tests run?

Unit tests are executed with npm test. For data safety, only GET operations are included in tests. GUI and CLI testing via MCP Inspector is also documented.