Redmine MCP
About
Integrates Claude AI with the Redmine project management system to enhance project management tasks.
Details
- Author
- zacharyelston
- Categories
- Productivity, Project Management
Jump to
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



