Redmine Connector MCP server

by Nikhilprasad-r·io.github.Nikhilprasad-r/redmine-mcp-connector·v1.0.1·1 stars

No reviews yet

stdio MCP server wrapping the Redmine REST API: issues, projects, users, time, wiki, versions.

B83/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B83/100

full report

Adoption

New

1 stars

Reviews

Write one

Nobody has reviewed Redmine Connector yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Redmine Connector tools (70, 31 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

redmine_attachment_deletewrite action
Delete attachment (DELETE /attachments/:id.json). Requires confirm: true.
redmine_attachment_download
Download attachment binary (GET /attachments/download/:id.json or .bin). Returns base64 and content_type; size capped by REDMINE_MAX_DOWNLOAD_BYTES.
redmine_attachment_get
Get attachment metadata (GET /attachments/:id.json).
redmine_attachment_updatewrite action
Update attachment metadata (PUT /attachments/:id.json).
redmine_attachment_uploadwrite action
Upload a file to Redmine (POST /uploads.json). Returns upload token; attach via issue/wiki update using uploads array.
redmine_current_user
Current user (GET /users/current.json).
redmine_custom_fields_list
List custom fields (GET /custom_fields.json).
redmine_enumerations_list
List enumeration values (GET /enumerations/:type.json) e.g. issue_priorities, time_entry_activities, document_categories.
redmine_group_get
Get group (GET /groups/:id.json).
redmine_groups_list
List groups (GET /groups.json). May require admin permissions.
redmine_issue_add_comment
Add a journal note to an issue (same as update with notes only).
redmine_issue_add_relation
Add a relation between issues (POST /issues/:id/relations.json).
redmine_issue_add_watcher
Add a watcher to an issue (POST /issues/:id/watchers.json).
redmine_issue_categories_list
List issue categories for a project (GET /projects/:id/issue_categories.json).
redmine_issue_category_createwrite action
Create issue category (POST /projects/:project_id/issue_categories.json).
redmine_issue_category_deletewrite action
Delete issue category (DELETE /issue_categories/:id.json). Requires confirm: true.
redmine_issue_category_get
Get issue category (GET /issue_categories/:id.json).
redmine_issue_category_updatewrite action
Update issue category (PUT /issue_categories/:id.json).
redmine_issue_createwrite action
Create an issue (POST /issues.json). Body uses Redmine issue JSON shape.
redmine_issue_deletewrite action
Delete an issue (DELETE /issues/:id.json). Requires confirm: true.
redmine_issue_get
Get a single issue (GET /issues/:id.json).
redmine_issue_relations_list
List relations for an issue (GET /issues/:id/relations.json).
redmine_issue_remove_relationwrite action
Delete an issue relation (DELETE /relations/:id.json). Requires confirm: true.
redmine_issue_remove_watcherwrite action
Remove a watcher from an issue (DELETE /issues/:issue_id/watchers/:user_id.json).
redmine_issue_statuses_list
List issue statuses (GET /issue_statuses.json).
redmine_issue_updatewrite action
Update an issue including notes/comments (PUT /issues/:id.json). Pass issue fields and optional notes.
redmine_issues_list
List issues (GET /issues.json). Supports filters and optional fetch_all to merge pages.
redmine_membership_createwrite action
Create membership (POST /projects/:project_id/memberships.json).
redmine_membership_deletewrite action
Delete membership (DELETE /memberships/:id.json). Requires confirm: true.
redmine_membership_updatewrite action
Update membership (PUT /memberships/:id.json).
redmine_news_createwrite action
Create news (POST /projects/:project_id/news.json or POST /news.json with project identifier).
redmine_news_deletewrite action
Delete news (DELETE /news/:id.json). Requires confirm: true.
redmine_news_get
Get news item (GET /news/:id.json).
redmine_news_list
List news (GET /news.json).
redmine_news_updatewrite action
Update news (PUT /news/:id.json).
redmine_project_archive
Archive project (PUT /projects/:id/archive.json).
redmine_project_createwrite action
Create project (POST /projects.json).
redmine_project_deletewrite action
Delete project (DELETE /projects/:id.json). Requires confirm: true.
redmine_project_get
Get project (GET /projects/:id.json).
redmine_project_memberships_list
List project memberships (GET /projects/:id/memberships.json).
redmine_project_unarchive
Unarchive project (PUT /projects/:id/unarchive.json).
redmine_project_updatewrite action
Update project (PUT /projects/:id.json).
redmine_projects_list
List projects (GET /projects.json).
redmine_queries_list
List saved queries visible to the user (GET /queries.json).
redmine_repository_revision_link_issue
Link an issue to a repository changeset (POST /projects/:id/repository/:repository_id/revisions/:rev/issues.json). Requires API permission on repository.
redmine_repository_revision_unlink_issue
Unlink an issue from a changeset (DELETE .../revisions/:rev/issues/:issue_id.json). Requires confirm: true.
redmine_request
Escape hatch: arbitrary Redmine REST call (disabled unless REDMINE_ALLOW_RAW_REQUEST=true). DELETE requires confirm: true.
redmine_role_get
Get role (GET /roles/:id.json).
redmine_roles_list
List roles (GET /roles.json).
redmine_search
Search Redmine (GET /search.json).
redmine_time_entries_list
List time entries (GET /time_entries.json).
redmine_time_entry_createwrite action
Create time entry (POST /time_entries.json).
redmine_time_entry_deletewrite action
Delete time entry (DELETE /time_entries/:id.json). Requires confirm: true.
redmine_time_entry_get
Get time entry (GET /time_entries/:id.json).
redmine_time_entry_updatewrite action
Update time entry (PUT /time_entries/:id.json).
redmine_trackers_list
List trackers (GET /trackers.json).
redmine_user_createwrite action
Create user (POST /users.json).
redmine_user_deletewrite action
Delete user (DELETE /users/:id.json). Requires confirm: true.
redmine_user_get
Get user (GET /users/:id.json).
redmine_user_updatewrite action
Update user (PUT /users/:id.json).
redmine_users_list
List users (GET /users.json). Admin may be required.
redmine_version_createwrite action
Create version (POST /projects/:project_id/versions.json).
redmine_version_deletewrite action
Delete version (DELETE /versions/:id.json). Requires confirm: true.
redmine_version_get
Get version (GET /versions/:id.json).
redmine_version_updatewrite action
Update version (PUT /versions/:id.json).
redmine_versions_list
List versions / roadmap for a project (GET /projects/:id/versions.json).
redmine_wiki_page_create_or_updatewrite action
Create or update wiki page (PUT /projects/:project/wiki/:title.json). Redmine uses update for new pages.
redmine_wiki_page_deletewrite action
Delete wiki page (DELETE /projects/:project/wiki/:title.json). Requires confirm: true.
redmine_wiki_page_get
Get wiki page (GET /projects/:project/wiki/:title.json).
redmine_wiki_pages_list
List wiki pages for a project (GET /projects/:id/wiki/index.json).

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings

Code scan45 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 0 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Redmine Connector compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 83/100; higher than 65% of 48,255 servers
Tools: 70; the typical server has 7
Tools that change things: 44%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 1; more than 65% of 28,688 servers

What its tools let an agent do: 39 read · 31 change

Install Redmine Connector in Claude Code, Cursor or VS Code

Runs npx -y redmine-mcp-connector on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add redmine-mcp-connector -- npx -y redmine-mcp-connector

Add to Cursor

What the publisher says

From the Redmine Connector repository's README, as published. We do not edit it. Read it on GitHub

Redmine MCP Server

stdio-based Model Context Protocol server that wraps a Redmine instance through its REST API (.json endpoints). It runs as a separate Node.js process; no changes to the Redmine Rails app** are required.

Requirements

Node.js 20+
A Redmine user with an API access key (My account → Show API access key)
Network access from this process to your Redmine REDMINEBASEURL

Install

No install needed for normal use — coding agents launch it on demand via npx:

npx -y redmine-mcp-connector

See CONNECTING.md for exact setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and any other MCP client, plus a local-build and Docker alternative.

To hack on the server itself, clone this repo instead:

npm install
npm run build

Configuration

Environment variables (see .env.example):

Run

REDMINE_BASE_URL=https://your-redmine.example.com REDMINE_API_KEY=secret npm start
# or during development:
REDMINE_BASE_URL=... REDMINE_API_KEY=... npm run dev

Connecting to a coding agent

Full per-client instructions (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, VS Code, Zed, and generic MCP clients) live in CONNECTING.md. Quick example (Claude Desktop / Cursor / Windsurf all share this shape):

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "redmine-mcp-connector"],
      "env": {
        "REDMINE_BASE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP resources (read-only)

Tools overview

Naming: redmine__.

Issues: redmineissueslist, redmineissueget, redmineissuecreate, redmineissueupdate, redmineissueaddcomment, redmineissue_delete (requires confirm: true), watchers add/remove, relations list/add/remove.

Projects: redmineprojectslist, redmineprojectget, create/update/archive/unarchive/delete (confirm for delete).

Users: redminecurrentuser, redmineuserslist, redmineuserget, create/update/delete (confirm for delete).

Time entries: list/get/create/update/delete (confirm for delete).

News: list/get/create/update/delete (confirm for delete).

Wiki: list pages, get page, create/update (PUT), delete (confirm).

Versions & categories: versions CRUD (confirm on delete), issue categories CRUD (confirm on delete).

Queries & metadata: redminequerieslist, redmineenumerationslist, redminetrackerslist, redmineissuestatuseslist, redmineroleslist, redmineroleget, redminecustomfieldslist.

Groups (read-only): redminegroupslist, redminegroupget.

Memberships: list/create/update/delete (confirm on delete).

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Redmine Connector: common questions

Is Redmine Connector MCP server safe?: Mostly: it is graded B (83/100). Read the Redmine Connector safety report
How do I install Redmine Connector?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Redmine Connector need an API key?: Yes. The registry entry asks for REDMINE_API_KEY.
Is Redmine Connector maintained?: The last commit was 41 days ago (2026-09-24). The latest release is v1.0.1.
How does Redmine Connector compare with other MCP servers?: safety score 83/100 (higher than 65% of 48,255 servers); tools 70 (the typical server has 7); tools that change things 44% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 83/100
Stars: 1
Downloads/wk: –
Price: Free
Licence: MIT
Transport: Local · npm
Version: 1.0.1
Category: Everything else
Last release: 2026-09-24

Credentials it needs

REDMINE_BASE_URLBase URL of your Redmine instance, no trailing slash (e.g. https://redmine.example.com)
REDMINE_API_KEYsecretRedmine API access key (My account -> Show API access key)
REDMINE_IMPERSONATE_USERAdmin-only impersonation login, sets X-Redmine-Switch-User
REDMINE_READONLYIf true, blocks all mutating HTTP methods (POST, PUT, PATCH, DELETE)
REDMINE_ALLOW_RAW_REQUESTIf true, registers the redmine_request escape-hatch tool for arbitrary REST paths
REDMINE_HTTP_TIMEOUT_MSHTTP timeout in milliseconds
REDMINE_MAX_PAGESMax pages when using fetch_all on list tools
REDMINE_MAX_DOWNLOAD_BYTESCap for redmine_attachment_download, in bytes (default 5 MiB)

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/nikhilprasad-r-redmine-mcp-connector.svg)](https://mcp.market/server/nikhilprasad-r-redmine-mcp-connector)

How the badge works