andrelaptenok/redmine-mcp-stdio

A local Model Context Protocol server (stdio) for Redmine. Point an MCP client at it (Cursor, VS Code, Claude, Codex, Windsurf, Cline, Zed, JetBrains AI and others) and work with Redmine issues, projects and time entries straight from the editor.
Tools
| Tool | What it does | Key parameters |
| ------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| list_issues | List/filter issues, paginated | project_id, status_id, assigned_to_id, query, limit, offset, all |
| get_issue | Full details of one issue + comments/history + attachments | id, include_journals (default true) |
| list_projects | Accessible projects | limit |
| get_project | Project details, versions and members | id |
| create_issue | Create an issue | project_id, subject, description, tracker_id, priority_id, assigned_to_id, status_id |
| update_issue | Update issue fields | id + any of subject, status_id, priority_id, assigned_to_id, done_ratio, notes |
| add_comment | Add a note to an issue | id, notes |
| log_time | Log a time entry on an issue/project | issue_id or project_id, hours, activity_id, comments, spent_on |
| list_time_entries | List time entries, filtered | issue_id, project_id, user_id, from, to, limit, offset |
| list_enumerations | IDs of trackers/statuses/priorities/activities | none |
| search | Full-text search (issues, wiki, news, …) | q, project_id, types, titles_only, open_issues, limit, offset |
| get_current_user | Account behind the API key (id, login, name) | none |
Every tool ships MCP tool annotations (readOnlyHint, destructiveHint, …), so clients can auto-approve read-only calls.
Install
No manual install needed. The client launches the server on demand with npx, which
downloads it on first run and caches it after. Just add the config for your client under
Connect.
Prefer to run from a local clone? See Development.
Get a Redmine API key
**My account > API access key > Show.**
- If there's no such section, an admin must enable the REST API in **Administration > Settings > API**.
- The key must belong to a user with permission to view (and, for writes, create/edit) issues.
> ⚠️ Never commit your API key. Copy .env.example to .env for local use; .env is gitignored.
Connect
The server reads REDMINE_URL and REDMINE_API_KEY from the environment. Provide them via the client's MCP config env block.
Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in a project root:
Reload Cursor and enable the server in **Settings > MCP**.
VS Code (GitHub Copilot)
Edit .vscode/mcp.json in your workspace (or your user mcp.json). Note the top-level key is servers, not mcpServers:
Claude Code
Or edit ~/.claude.json / the project .mcp.json directly (same shape as Claude Desktop below).
Claude Desktop
Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
Restart Claude Desktop afterwards.
Codex CLI
Add a server table to ~/.codex/config.toml:
If node is installed via nvm, use the full path from which npx as command.
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json: