Skip to main content
Glama

Redmine MCP Server

by snowild
GitHub
Python
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Redmine MCP Server

A Model Context Protocol (MCP) server for Redmine integration, enabling Claude Code to directly interact with Redmine project management systems.

🚀 Features

✅ Issue Management

  • Query Issues: Get detailed issue information and lists
  • Create Issues: Create new issues and set related attributes
  • Update Issues: Modify issue content, status, priority, etc.
  • Assign Issues: Assign or unassign issues to specific users
  • Add Notes: Add public or private notes to issues
  • Close Issues: Automatically set issues to completed status

✅ Project Management

  • Project Lists: Get accessible project lists
  • Project Issues: Filter by status and list all issues in projects

✅ Search Features

  • Keyword Search: Search for keywords in issue titles and descriptions
  • My Issues: Quick view of issues assigned to current user

✅ System Tools

  • Health Check: Verify MCP server and Redmine connection status
  • Status Query: Get available issue status lists

📋 System Requirements

  • Python: 3.12 or higher
  • Redmine: Version with REST API support (recommended 4.0+)
  • Package Manager: uv or pip

🔧 Installation & Setup

1. Clone the Project

git clone https://github.com/snowild/redmine-mcp.git cd redmine-mcp

2. Install Dependencies

Using uv (recommended):

uv sync

Or using pip:

pip install -e .

3. Environment Configuration

Create a .env file:

cp .env.example .env

Edit the .env file and set the following environment variables:

REDMINE_DOMAIN=https://your-redmine-domain.com REDMINE_API_KEY=your_api_key_here REDMINE_TIMEOUT=30 DEBUG_MODE=false

4. Redmine API Setup

4.1 Enable REST API
  1. Log in to Redmine as administrator
  2. Go to Administration → Settings → API
  3. Check "Enable REST web service"
  4. Click Save
4.2 Configure Redmine Basic Data (Administrator)

Before using MCP tools, you need to configure Redmine's basic data:

Configure Roles and Permissions

  1. Go to Administration → Roles and permissions
  2. Create or edit roles (e.g.: Developer, Tester, Project Manager)
  3. Assign appropriate permissions to roles (recommend at least: View issues, Add issues, Edit issues)

Configure Trackers

  1. Go to Administration → Trackers
  2. Create tracker types (e.g.: Bug, Feature, Support)
  3. Set default status and workflow for each tracker

Configure Issue Statuses

  1. Go to Administration → Issue statuses
  2. Create statuses (e.g.: New, In Progress, Resolved, Closed, Rejected)
  3. Set status attributes (whether it's a closed status, etc.)

Configure Workflow

  1. Go to Administration → Workflow
  2. Set allowed status transitions for each role and tracker combination
  3. Ensure basic status transition paths (New → In Progress → Resolved → Closed)

Create Projects

  1. Go to Projects → New project
  2. Set project name, identifier, description
  3. Select enabled modules (at least enable "Issue tracking")
  4. Assign members and set roles
4.3 Get API Key
  1. Log in to your Redmine system (can be administrator or regular user)
  2. Go to My account → API access key
  3. Click Show or Reset to get the API key
  4. Copy the key to REDMINE_API_KEY in the .env file

⚠️ Important Notes:

  • If you can't find the API key option, please ensure step 4.1 (Enable REST API) is completed
  • Complete basic setup before you can properly create and manage issues

📚 Detailed Setup Guide: For complete Redmine setup steps, please refer to Redmine Complete Setup Guide

🔗 Claude Code Integration

Install to Claude Code

# Install from local uv tool install . # Or using pip pip install . # Add to Claude Code MCP configuration claude mcp add redmine "redmine-mcp" \ -e REDMINE_DOMAIN="https://your-redmine-domain.com" \ -e REDMINE_API_KEY="your_api_key_here"

Verify Installation

# Test MCP server uv run python -m redmine_mcp.server # Test Claude Code integration uv run python tests/scripts/claude_integration.py

🛠️ Available MCP Tools

Basic Tools

Tool NameDescription
server_infoDisplay server information and configuration status
health_checkCheck server and Redmine connection health status

Issue Operations

Tool NameDescription
get_issueGet detailed information of specified issue
create_new_issueCreate a new issue
update_issue_statusUpdate issue status
update_issue_contentUpdate issue content (title, description, etc.)
add_issue_noteAdd notes to issues
assign_issueAssign or unassign issues
close_issueClose issue and set completion rate

Query Tools

Tool NameDescription
list_project_issuesList issues in projects
get_my_issuesGet list of issues assigned to me
search_issuesSearch for issues containing keywords
get_projectsGet list of accessible projects
get_issue_statusesGet all available issue statuses
get_trackersGet all available tracker lists
get_prioritiesGet all available issue priorities
get_time_entry_activitiesGet all available time tracking activities
get_document_categoriesGet all available document categories

💡 Usage Examples

Using in Claude Code

# Check server status Please run health check # Get project list Show all accessible projects # View system settings Get all available issue statuses Get all available tracker lists Get all available issue priorities Get all available time tracking activities Get all available document categories # View specific issue Get detailed information for issue #123 # Create new issue Create an issue in project ID 1: - Title: Fix login error - Description: Users cannot log in to the system properly - Priority: High # Search issues Search for issues containing "login" keyword # Update issue status Update issue #123 status to "In Progress" with note "Starting to handle this issue"

🧪 Testing

Run Test Suite

# Run all tests uv run python -m pytest # Run MCP integration tests uv run python tests/scripts/mcp_integration.py # Run Claude Code integration tests uv run python tests/scripts/claude_integration.py

Docker Environment Testing

If you want to test in a local Docker environment:

# Start Redmine test environment docker-compose up -d # Quick start complete test environment ./quick_start.sh

🔍 Troubleshooting

Common Issues

1. API Authentication Failed (401/403 errors)

  • Verify API key is correct
  • Check if Redmine has REST API enabled: Go to Administration → Settings → API, check "Enable REST web service"
  • Verify user permissions are sufficient
  • Check if URL is correct (including http/https and port)

2. Connection Timeout

  • Check network connection
  • Adjust REDMINE_TIMEOUT environment variable
  • Verify Redmine server status

3. Issue Creation Failed

  • Verify project exists and has permissions
  • Check if required fields are filled
  • Verify tracker and status settings
  • Check basic data configuration: Ensure roles, trackers, statuses, and workflow setup is complete
  • Verify user has appropriate role and permissions in the project

4. Status Update Failed

  • Check if workflow allows the status transition
  • Verify user role has permission to change status
  • Verify target status ID is correct

5. Project or Issue Not Found

  • Verify ID is correct
  • Check if user has permission to view the project/issue
  • Verify project status is active

Debug Mode

Enable debug mode for more detailed error information:

DEBUG_MODE=true

📁 Project Structure

redmine-mcp/ ├── src/redmine_mcp/ # Main source code │ ├── __init__.py # Package initialization │ ├── server.py # MCP server main program │ ├── redmine_client.py # Redmine API client │ ├── config.py # Configuration management │ └── validators.py # Data validation ├── tests/ # Test files ├── docs/ # Documentation directory ├── docker-compose.yml # Docker test environment ├── pyproject.toml # Project configuration └── README.md # Project documentation

🤝 Contributing

  1. Fork this project
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

If you have any questions or suggestions, feel free to open an Issue or contact the project maintainers.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A Model Context Protocol server that enables Claude Code to directly interact with Redmine project management systems, supporting issue management, project operations, and search features.

  1. 🚀 Features
    1. ✅ Issue Management
    2. ✅ Project Management
    3. ✅ Search Features
    4. ✅ System Tools
  2. 📋 System Requirements
    1. 🔧 Installation & Setup
      1. Clone the Project
      2. Install Dependencies
      3. Environment Configuration
      4. Redmine API Setup
    2. 🔗 Claude Code Integration
      1. Install to Claude Code
      2. Verify Installation
    3. 🛠️ Available MCP Tools
      1. Basic Tools
      2. Issue Operations
      3. Query Tools
    4. 💡 Usage Examples
      1. Using in Claude Code
    5. 🧪 Testing
      1. Run Test Suite
      2. Docker Environment Testing
    6. 🔍 Troubleshooting
      1. Common Issues
      2. Debug Mode
    7. 📁 Project Structure
      1. 🤝 Contributing
        1. 📄 License
          1. 🔗 Related Links

            Related Resources

            Related MCP Servers

            • Redmine MCP Server

              yonaka15
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server for interacting with Redmine using its REST API, enabling the management of tickets, projects, and user data through integration with LLMs.
              Last updated -
              23
              40
              TypeScript
              MIT License

            • Linear MCP Server

              cpropster
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
              Last updated -
              30
              1
              TypeScript
              MIT License

            • MCP Development Server

              dillip285
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables Claude to manage software development projects with complete context awareness and code execution through Docker environments.
              Last updated -
              1
              Python
              • Apple

            • Claude Code MCP

              auchenberg
              A
              security
              A
              license
              A
              quality
              An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
              Last updated -
              8
              86
              JavaScript
              MIT License

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/snowild/redmine-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server