Redmine MCP

by zacharyelston

Not rated
GitHub

About

Integrates Claude AI with the Redmine project management system to enhance project management tasks.

Details

Author
zacharyelston
Categories
Productivity, Project Management

Setup

Install Redmine MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/zacharyelston/RedmineMCP

Follow the installation instructions in the repository README, then restart your MCP client.

- Company in a Box
- Designed to breathe.
- Built to think.
- Yours to evolve.

An integration between Claude AI (or any MCP client - Like Windsurf) and Redmine using the Model Context Protocol (MCP).[](https://github.com/zacharyelston/RedmineMCP/blob/Master/docs/ex2.jpg)<<<

You can use the existing tooling like Jira MCP servers to accomplish this. We disagree with Jira's structure and design as Redmine allows entire Projects to be shifted or rehomed without issue. If you want an 100% OpenSource solution, keep reading.

The Redmine MCP project provides a seamless connection between Claude AI and Redmine project management system. It allows Claude to access and manipulate Redmine data through a TypeScript implementation of the Model Context Protocol.

This project represents a paradigm shift in how organizations structure collaboration between humans and AI. As described in ourNASCAR DevOps philosophy, we've entered an era where "everyone's driving the same car" through standardized protocols like MCP. The difference now lies in the team—how humans and AI coordinate, communicate, and collectively solve problems.

By implementing this system, you're not just deploying a tool but creating aCompany in a Box—a central nervous system where:

- AI agents handle routine operations while humans focus on strategy and creativity
- Work becomes visible, traceable, and continuously improvable
- Human value shifts from task execution to mentorship and process improvement
- Organizational knowledge persists beyond individual contributors
- Teams build a collective intelligence that compounds over time

The Redmine MCP integration transforms your organization into one where technology handles the routine, while humans focus on creativity, foresight, and meaning.

and NO - it's not 100% complete yet. There is ~ 90% more to go for full functionality and V2 will be where we start working on plugins. So jump in and help out.

- TypeScript MCP Server: A robust implementation that connects Claude to Redmine
- Redmine Development Environment: A Docker-based Redmine setup for development and testing
- CI/CD Integration: GitHub and GitLab pipeline configurations with bi-directional sync
- Comprehensive Documentation: Guides and troubleshooting information

- Project Management: List and view Redmine projects with detailed information
- Issue Tracking: Create, update, list and view issues with full parameter support
- Parent-Child Relationships: Create and manage subtasks with hierarchical structure
- Issue Relations: Create, view, and manage issue relationships (relates, blocks, etc.)
- User Information: Access current user details and permissions
- Robust Error Handling: Detailed error reporting and parameter validation
- Mock Mode: Development and testing without requiring a Redmine instance

The mock mode feature allows for development, testing, and demonstrations without requiring an active Redmine instance. This is particularly valuable for:

- Offline development work
- Isolated testing environments
- Demonstrations and presentations
- Consistent and reproducible behaviors

The TypeScript implementation includes a complete mock data provider that simulates all Redmine operations with predictable responses.
- Clone this repository
- Create a.envfile with your Redmine API key (see.env.examplein redmcp-typescript)
- Navigate toredmcp-typescript/directory
- Install dependencies withnpm install
- Build the project withnpm run build
- Start the server withnpm start
- Configure Claude Desktop to use the MCP server

redmine-mcp/ ├── .github/ # GitHub Actions workflows and configuration ├── docs/ # Project documentation ├── prompt.yaml # MCP protocol configuration and tool definitions ├── redmcp-typescript/ # TypeScript implementation of the MCP server ├── redmine-server/ # Development environment with Docker setup └── README.md # This file

The core of this project is the TypeScript implementation of the MCP server. It provides:

- Robust connection to Redmine API
- Type-safe parameter handling
- Comprehensive error management
- Full support for Redmine operations

For detailed information, see theredmcp-typescript README.

The project includes a Redmine development environment in theredmine-server/directory. This provides a consistent PostgreSQL database setup using Docker with:

- Predefined users with API keys
- Sample projects and issues
- Default configuration
- Navigate to theredmine-server/directory
- Rundocker-compose up -dto start the environment
- Use the predefined API keys for testing:

- redmine_projects_list: List all accessible projects
- redmine_projects_get: Get details of a specific project

- redmine_issues_list: List issues with optional filtering
- redmine_issues_get: Get details of a specific issue
- redmine_issues_create: Create a new issue
- redmine_issues_update: Update an existing issue

- redmine_issue_create_subtask: Create a subtask under a parent issue
- redmine_issue_set_parent: Set or change the parent of an existing issue
- redmine_issue_remove_parent: Remove parent relationship (make top-level)
- redmine_issue_get_children: Get all child issues of a parent

- redmine_issue_relations_get: Get all relations for an issue
- redmine_issue_relation_create: Create a relation between issues
- redmine_issue_relation_delete: Delete an issue relation
- redmine_issue_comment_add: Add a comment to an issue

- redmine_users_current: Get current user information

For detailed parameter information, see theredmcp-typescript READMEand theparent-child relationships documentation.

To use this MCP server with Claude Desktop, add the following configuration to Claude Desktop's configuration file:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "redmine": { "command": "node", "args": ["/absolute/path/to/redmcp-typescript/build/index.js"], "env": { "REDMINE_URL": "http://your-redmine-instance.com", "REDMINE_API_KEY": "your-api-key-here", "LOG_LEVEL": "info" } } } }

Example configurations are available in theredmcp-typescript/docs/directory.

For detailed troubleshooting steps and solutions, see theTROUBLESHOOTING.mdfile.

- Ensure your Redmine instance is accessible and the API key has appropriate permissions
- When creating issues, ensure the priority_id field is included (required by Redmine)
- Check Claude Desktop logs at~/Library/Logs/Claude/(macOS) for error messages

SeeTODO.mdfor planned enhancements and future development.

The project includes comprehensive CI/CD configurations for both GitHub Actions and GitLab CI:

Located in the.github/workflows/directory:

- Main CI/CD Pipeline: Mirrors the GitLab CI pipeline with install, lint, build, and test stages
- GitLab Sync: Automatically syncs changes from GitHub to GitLab
- GitHub Sync: Pulls changes from GitLab to GitHub on schedule or manual trigger

To use the GitHub workflows, the following secrets must be configured:

- GITLAB_URL: The URL of your GitLab repository
- GITLAB_TOKEN: GitLab Personal Access Token with repo write permissions
- GITLAB_PROJECT_ID: Your GitLab project ID
- SYNC_GITHUB_TOKEN: GitHub Personal Access Token for creating pull requests

- Dependencies installation
- Code linting
- Project building
- Automated testing
- Special test for subproject creation

For more details, see the.github/README.mdfile.

- API keys are stored separately in.envfiles
- Development API keys should never be used in production
- Always use secure connections (HTTPS) for production deployments
- CI/CD secrets should have minimal required permissions

Interact with task, doc, and project data in Dart, an AI-native project management tool

Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp

The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.

Keep teams & agents coordinated automatically

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.

Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.

Official Taskeract MCP Server for integrating your Taskeract project tasks and load the context of your tasks into your MCP enabled app.

Manage your Todoist tasks and projects directly from your LLM.

Interact with Asana tasks, projects, workspaces, and comments using the Asana API.

Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.