Redmine MCP Server

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.