Redmine MCP Server
You can use this MCP server to manage Redmine issues, projects, time entries, and search from an AI assistant.
List, get, create, update, and delete issues with filters, sorting, pagination, and fetch-all support.
Add and remove issue watchers, and update issue notes/private notes.
List, get, create, update, delete, archive, and unarchive projects, including project settings and custom fields.
List and get time entries with date, user, issue, project, and pagination filters.
Run full-text search across Redmine resources such as issues, projects, news, documents, wiki pages, messages, and changesets.
Rely on built-in authentication, pagination, input validation, and error handling.
Provides tools for interacting with a Redmine instance, including managing issues (create, update, delete, list, add/remove watchers), managing projects (create, update, delete, archive, unarchive), and performing full-text search across Redmine resources.
Click on "Deploy 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., "@Redmine MCP Server List all open issues assigned to me"
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.
Redmine MCP Server
An MCP (Model Context Protocol) server that connects AI assistants like Kiro to your Redmine instance. It exposes 18 tools covering Issues, Projects, Time Entries, and Search — allowing your AI assistant to create issues, update projects, search across resources, and more, all through natural conversation.
What it does
Once configured, you can ask your AI assistant things like:
"List all open issues assigned to me"
"Create a bug report for the login page crash"
"Search for issues related to database migration"
"Archive the old-website project"
"Add John as a watcher on issue #42"
The server handles authentication, pagination, input validation, and error handling automatically.
Related MCP server: @a-bonus/redmine-mcp
Available tools
Domain | Tools |
Issues | list, get, create, update, update note, delete, add watcher, remove watcher |
Projects | list, get, create, update, delete, archive, unarchive |
Search | full-text search across all Redmine resources |
Prerequisites
Python 3.10+ installed on your machine
uv — a fast Python package manager (install guide)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Redmine API key — get yours from your Redmine instance:
Log in to Redmine
Go to My Account (top-right menu)
In the right sidebar, find API access key and click Show
Copy the key
Setup with Kiro
Step 1: Add the MCP server config to Kiro
Create or edit ~/.kiro/settings/mcp.json (this makes it available across all your projects):
{
"mcpServers": {
"redmine": {
"command": "uvx",
"args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}Replace:
https://your-redmine-instance.comwith your Redmine URLyour-api-key-herewith your Redmine API key
You can also place this in .kiro/settings/mcp.json within a specific workspace if you only want it available there.
Step 2: Open Kiro
The MCP server will start automatically when Kiro launches. You can verify it's working by asking: "List my Redmine projects."
Alternative: If git is not installed
If you get a "Git executable not found" error, you can use a zip-based install that doesn't require git on your machine:
{
"mcpServers": {
"redmine": {
"command": "uvx",
"args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}Alternative setup: Local install
If you prefer to run from a local clone instead of uvx:
git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install .Then use this MCP config instead:
{
"mcpServers": {
"redmine": {
"command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
"args": [],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}Troubleshooting
Problem | Solution |
"REDMINE_URL environment variable is missing" | Make sure |
"REDMINE_API_KEY environment variable is missing" | Ensure |
"Authentication failed: invalid or expired API key" | Verify your API key is correct in Redmine → My Account → API access key |
"Connection failed" | Check that the |
Tools not appearing in Kiro | Confirm the |
"Git executable not found" | Git is not installed or not on PATH. Use the zip-based install instead, or install git and restart your terminal |
Development
git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytestAvailable Tools
17 toolsadd_watcherAdd WatcherC
Add a watcher to an issue.
Inputs: user_id (required), issue_id (required). Returns: object
archive_projectArchive ProjectC
Archive a project.
Inputs: project_id (required). Returns: object
create_issueCreate IssueC
Create a new issue in a project.
Inputs: subject (required), project_id (required), status_id, done_ratio, +11 more. Returns: object
create_projectCreate ProjectD
Create a new project.
Inputs: name (required), identifier (required), homepage, is_public, +9 more. Returns: object
delete_issueDelete IssueC
Delete an issue permanently.
Inputs: issue_id (required). Returns: object
delete_projectDelete ProjectC
Delete a project permanently.
Inputs: project_id (required). Returns: object
get_issueGet IssueC
Get detailed information about a specific issue.
Inputs: issue_id (required), include. Returns: object
get_projectGet ProjectC
Get detailed information about a specific project.
Inputs: project_id (required), include. Returns: object
get_time_entryGet Time EntryC
Get detailed information about a specific time entry.
Inputs: time_entry_id (required). Returns: object
list_issuesList IssuesC
List issues with optional filters and pagination.
Inputs: sort, limit, offset, fetch_all, +6 more. Returns: object
list_projectsList ProjectsB
List all accessible projects with pagination.
Inputs: limit, offset, include. Returns: object
list_time_entriesList Time EntriesB
List time entries with optional filters and pagination.
Inputs: limit, offset, to_date, user_id, +4 more. Returns: object
remove_watcherRemove WatcherC
Remove a watcher from an issue.
Inputs: user_id (required), issue_id (required). Returns: object
searchSearchD
Search across Redmine resources.
Inputs: query (required), news, limit, scope, +10 more. Returns: object
unarchive_projectUnarchive ProjectC
Unarchive a project.
Inputs: project_id (required). Returns: object
update_issueUpdate IssueD
Update an existing issue.
Inputs: issue_id (required), notes, subject, due_date, +15 more. Returns: object
update_projectUpdate ProjectC
Update an existing project.
Inputs: project_id (required), name, homepage, is_public, +9 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools target a distinct resource+action pair (issues, projects, watchers, time entries), making boundaries clear. The generic 'search' tool mildly overlaps with filtered list_issues/list_projects, but descriptions keep them separable.
Every tool follows a strict verb_noun convention: list_/get_/create_/update_/delete_/add_/remove_/archive_/unarchive_ plus a clear resource noun. Highly predictable with no deviations.
17 tools sits at the heavier end of the range but is justified by covering multiple resources: full issue CRUD, project CRUD plus archive/unarchive, watchers, and time entries. Nothing feels redundant.
Issues and projects have full lifecycle coverage including archive/unarchive and watchers. Time entries only support read (list/get) with no create/update/delete, a notable gap for a time-tracking-centric tool like Redmine.
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for AI dialogue using various LLM models via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3325 npm6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Redmine that enables interaction with issues, wiki pages, and time entries through natural language.ISC
- AlicenseAqualityCmaintenanceMCP server for Redmine integration, enabling AI assistants to manage issues, upload files, automate workflows, and handle wiki pages.18MIT
- FlicenseAqualityDmaintenanceAn MCP server that connects AI agents to Redmine project data, enabling natural language access to issues, projects, time entries, and more via the REST API.21-