Mcp Redmine

What is Mcp Redmine?

Mcp Redmine is a Model Context Protocol (MCP) server that provides seamless integration with Redmine project management software. It allows AI assistants to interact with Redmine through a comprehensive set of tools for managing projects, issues, users, time tracking, wiki pages, and more. It is built for developers and teams using Redmine 4.1.1.stable (compatible with Redmine 4.0+).

How to use Mcp Redmine?

Install by cloning the repository, running npm install, setting environment variables (REDMINE_BASE_URL and an API key or username/password), and building with npm run build. Start the server in production with npm start, or use npm run dev for development with auto-reload. Configure your MCP client to use the server with the command node dist/index.js via stdio transport.

Key features of Mcp Redmine

• Project CRUD, version, category, and roadmap management
• Issue tracking with advanced filtering, assignment, and status management
• User management: list users, get details, current user info
• Time tracking: create and list time entries, activity‑based logging
• Wiki page management: list, get, create, update, delete
• Search across all Redmine content, file upload, and attachment retrieval
• Administrative tools: roles, groups, project memberships, trackers, issue statuses, priorities

Use cases of Mcp Redmine

• AI‑assisted issue triage and assignment in Redmine projects
• Automated time logging based on natural language commands
• Streamlined project setup: create projects, versions, and categories via chat
• Querying project data (issues, users, wiki) without leaving the MCP client
• Bulk operations like creating issue relations or managing group memberships

FAQ from Mcp Redmine

What versions of Redmine are supported?

Mcp Redmine is developed and tested for Redmine 4.1.1.stable. It requires Redmine 4.0+ with REST API enabled. Optimal functionality is guaranteed with 4.1.1.stable.

How do I authenticate with my Redmine instance?

You can authenticate using either an API key (recommended) or a username/password pair. Set REDMINE_API_KEY or REDMINE_USERNAME/REDMINE_PASSWORD in your .env file. Optionally, use REDMINE_IMPERSONATE_USER to act as another user (admin rights required).

What are the runtime requirements?

Node.js 18 or higher and a Redmine instance with REST API enabled. The server runs via stdio and is invoked with the command node dist/index.js.

How do I get my Redmine API key?

Log into Redmine, go to “My account”, click “API access key” in the sidebar, then “Show” to reveal your key. Copy it into the REDMINE_API_KEY environment variable.

Does Mcp Redmine support file attachments?

Yes. The upload_file tool uploads files to Redmine and returns an attachment token for use in issues or wiki pages. The get_attachment tool retrieves attachment details.