mcp-server-redmine
Allows interaction with the Redmine REST API, providing tools for managing issues, issue relations, projects, users, time entries, wiki pages, news, files, search, and roles within a Redmine instance.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-redminelist my open issues"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-redmine
MCP server for the Redmine REST API. Exposes 32 tools covering Issues, Issue Relations, Projects, Users, My Account, Time Entries, Wiki Pages, News, Files, Search, and Roles via stdio transport.
Installation
pnpm add mcp-server-redmineOr use directly via npx:
npx mcp-server-redmineRelated MCP server: redmine-mcp
Configuration
Two environment variables are required:
Variable | Description |
| Base URL of your Redmine instance, e.g. |
| Your Redmine API access key (found in My account → API access key) |
Claude Desktop Setup
Add to claude_desktop_config.json:
Note: In Claude Desktop, open Settings → Developer → Edit Config. This opens (or creates)
claude_desktop_config.jsonin your default editor. After saving, fully quit Claude Desktop (not just minimize) and reopen it for the changes to take effect.
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["mcp-server-redmine"],
"env": {
"REDMINE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your-api-key"
}
}
}
}Claude Code Setup
Run from your project root:
claude mcp add-json redmine '{"command":"npx","args":["mcp-server-redmine"],"env":{"REDMINE_URL":"https://redmine.example.com","REDMINE_API_KEY":"your-api-key"}}'Or add manually to .mcp.json at the root of your project:
{
"mcpServers": {
"redmine": {
"command": "npx",
"args": ["mcp-server-redmine"],
"env": {
"REDMINE_URL": "https://redmine.example.com",
"REDMINE_API_KEY": "your-api-key"
}
}
}
}Tools
Issues
Tool | Status | Description |
| ✓ | List issues with filters: project, status, tracker, assignee, priority, pagination |
| ✓ | Get a single issue by numeric ID |
| ✓ | Create a new issue in a project |
| ✓ | Update fields on an existing issue |
| ✓ | Permanently delete an issue |
Issue Relations
Tool | Status | Description |
| ⚠ | List all relations for a given Redmine issue |
| ⚠ | Get a single relation by its numeric ID |
| ⚠ | Create a relation between two issues (relates, blocks, precedes, duplicates, …) |
| ⚠ | Permanently delete a relation |
Projects
Tool | Status | Description |
| ✓ | List all accessible projects |
| ✓ | Get a project by identifier (slug) or numeric ID |
| ✓ | Create a new project |
| ✓ | Update an existing project |
Users
Tool | Status | Description |
| ✓ | List users (requires admin privileges) |
| ✓ | Get a user by numeric ID |
| ✓ | Get the authenticated user's profile |
My Account
Tool | Status | Description |
| ⚠ | Get the authenticated user's account details, API key, and custom fields |
Time Entries
Tool | Status | Description |
| ✓ | List time entries with filters: project, issue, user, date range |
| ✓ | Get a single time entry by numeric ID |
| ✓ | Log hours against an issue or project |
| ✓ | Update an existing time entry |
| ✓ | Permanently delete a time entry |
Wiki Pages
Tool | Status | Description |
| ⚠ | List all wiki pages in a project |
| ⚠ | Get wiki page content by project and title |
| ⚠ | Create or update a wiki page |
| ⚠ | Permanently delete a wiki page (requires admin) |
News
Tool | Status | Description |
| ⚡ | List news articles with optional project filtering |
Files
Tool | Status | Description |
| ⚠ | List all files in a project with metadata |
| ⚠ | Upload a file to a project |
Search
Tool | Status | Description |
| ⚠ | Search issues, wiki pages, news, documents, changesets, messages, and projects |
Roles
Tool | Status | Description |
| ⚠ | List all roles with IDs and names |
| ⚠ | Get role details including permissions |
API Stability
The tools follow Redmine's API resource stability levels:
Status | Meaning |
✓ Stable | Feature complete, no major changes planned |
⚠ Alpha | Major functionality in place, needs feedback from integrators |
⚡ Prototype | Rough implementation, possible breaking changes. Not recommended for production |
Development
# Install dependencies
pnpm install
# Build
pnpm build
# Watch mode
pnpm dev
# Tests
pnpm test
# Type check
pnpm typecheckContributing
Contributions are welcome! Please read the Contributing Guide for setup instructions, the project structure, and how to add a new tool. Bug reports and feature requests go through the issue templates.
Security
Found a vulnerability? Please report it privately — see our Security Policy. Do not open a public issue for security problems.
License
MIT © Jesus Reikel Lopez Martin
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/jesusr00/mcp-server-redmine'
If you have feedback or need assistance with the MCP directory API, please join our Discord server