MCP Redmine

🚀 MCP Redmine

Connect Claude Desktop to your Redmine instance and enhance project management efficiency.

🚀 Quick Start

The project is in good working condition and is used daily without known errors. I've just added the package to PyPI and updated the usage instructions. Please report any issues!

MCP Redmine connects Claude Desktop to your Redmine instance, enabling it to:

• Search for and browse projects and issues.
• Create and update issues with full Markdown support.
• Upload and download file attachments.
• Manage and track time entries.
• Update issue statuses and fields.
• Access comprehensive Redmine API features.

It uses httpx for API requests and integrates with the Redmine OpenAPI specification for full API coverage.

✨ Features

• Comprehensive Functionality: Supports various operations on Redmine, including issue management, file handling, and time tracking.
• API - Integrated: Utilizes httpx and Redmine OpenAPI specification for seamless API interaction.
• Markdown Support: Allows for creating and updating issues with Markdown formatting.

📦 Installation

Ensure you have uv installed:

# If not installed, run the following command to install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

💻 Usage Examples

Basic Usage

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "mcp-redmine==2025.04.09.153531", "mcp-redmine"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your-api-key",
        "REDMINE_REQUEST_INSTRUCTIONS": "/path/to/instructions.md"
      }
    }
  }
}

Advanced Usage

Here are some examples of using MCP Redmine with Claude:

Create a New Issue

Let's create a new bug report in the "Website" project:
1. Title: "Homepage fails to load on mobile devices"
2. Description: "When accessing the homepage from iOS or Android devices, a loading indicator appears but the content never loads. This issue started after the last deployment."
3. Priority: High
4. Assigned to: John Smith

Search for Issues

Can you find all unassigned issues with high priority in the "Website" project?

Update Issue Status

Please mark issue #123 as "In Progress" and add a comment: "I've started working on this issue. It's expected to be completed by Friday."

Record Time

Record 3.5 hours of progress today on issue #456 for "Implementing user authentication".

📚 Documentation

Environment Variables

🤝 Contributing

Contributions are welcome! Whether it's bug reports, feature requests, documentation improvements, or code contributions - all feedback is valuable. Please feel free to:

• Open an issue to report bugs or suggest features.
• Submit pull requests with improvements.
• Enhance the documentation or share your usage examples.
• Ask questions and share your experiences.

Our goal is to make Redmine project management integrate better with Claude, and your insights and contributions will help us achieve this.

🙏 Acknowledgments

This project builds on the excellent work of others:

• httpx - Handles HTTP requests.
• Redmine OpenAPI specification - Used for comprehensive API specification.
• Redmine - A flexible project management web application.

📄 License

This project is licensed under the Mozilla Public License 2.0.

🌟 Other LLM Projects

• MCP Alchemy - Connects Claude Desktop to databases to explore schemas and run SQL.
• MCP Notmuch Sendmail - An email assistant for Claude Desktop using notmuch.
• Diffpilot - A multi - column git diff viewer with file grouping and tagging features.
• Claude Local Files - Access local files in the Claude Desktop plugin.