Redmine

You can run this MCP server to access Redmine project data through MCP tools, letting AI assistants query projects, issues, and wiki content while securely serving attachments. It supports flexible authentication, HTTP file access, and containerized deployment, making it easy to integrate Redmine data into MCP-enabled workflows.

How to use

To use the server, start it on your host and connect your MCP client to the provided HTTP endpoint. The MCP endpoint is accessible at the server’s host and port, and a health check endpoint helps you verify the server is running. Once connected, you can list projects, view and manage issues, search and edit wiki pages, and retrieve secure download URLs for attachments. Ensure your MCP client is configured to point to http://localhost:8000/mcp or the appropriate host URL if you are running remotely.

How to install

Prerequisites: Python 3.10 or newer for local installation. Docker is available for containerized deployment if you prefer not to install Python directly.

Step 1: Install the package using Python’s package manager.

pip install redmine-mcp-server

Step 2: Create a configuration file with your Redmine credentials and server settings. Include the Redmine URL and authentication details you plan to use.

Step 3: Start the MCP server with the CLI command.

redmine-mcp-server

Additional setup and running notes

The server runs on http://localhost:8000 with the MCP endpoint at /mcp, a health endpoint at /health, and a file serving path at /files/{file_id}.

Available tools

list_redmine_projects

List all accessible Redmine projects that the MCP server can retrieve.

summarize_project_status

Provide a comprehensive status overview for a specified Redmine project.

get_redmine_issue

Fetch detailed information about a specific Redmine issue.

list_my_redmine_issues

List issues assigned to the authenticated user with optional pagination.

search_redmine_issues

Search issues using a text query across Redmine data.

create_redmine_issue

Create a new issue in Redmine with provided details.

update_redmine_issue

Update an existing Redmine issue with new data.

search_entire_redmine

Globally search across issues and wiki pages (Redmine 3.3.0+).

get_redmine_wiki_page

Retrieve content of a Redmine wiki page.

create_redmine_wiki_page

Create a new Redmine wiki page.

update_redmine_wiki_page

Update an existing Redmine wiki page.

delete_redmine_wiki_page

Delete a Redmine wiki page.

get_redmine_attachment_download_url

Obtain secure download URLs for Redmine attachments.

cleanup_attachment_files

Remove expired attachment files from storage.