Log inSubmit server
Redmine MCP Stdio logo

Redmine MCP Stdio

by andrelaptenok

Connects MCP clients to Redmine for issue, project, search, comment, and time-entry operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Redmine MCP Stdio

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "andrelaptenok-redmine-mcp-stdio": {
      "command": "npx",
      "args": [
        "-y",
        "redmine-mcp-stdio"
      ],
      "env": {
        "REDMINE_URL": "YOUR_VALUE_HERE",
        "REDMINE_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y redmine-mcp-stdio

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

andrelaptenok/redmine-mcp-stdio MCP server connects MCP-compatible clients to a Redmine instance over a local stdio process. It exposes 12 tools for browsing, searching, creating, and updating issues, inspecting projects, adding comments, and recording time. Configure the Redmine URL and API key in the client environment, then launch the package with npx. Reach for it when an agent needs structured access to Redmine work-management data from an editor or coding assistant.

Use cases

  • Search Redmine issues and related wiki content from an editor
  • Create and update Redmine issues through an MCP client
  • Review project members, versions, comments, history, and attachments
  • Add issue notes and record time against projects or issues

Key features

  • 12 Redmine tools over local stdio
  • Issue search, creation, updates, comments, journals, and attachments
  • Project details, versions, and members
  • Time-entry logging and filtered reporting
  • MCP safety annotations on every tool
  • API-key authentication through environment variables

Tools12

What Redmine MCP Stdio lets your agent do. Expand a tool for its parameters.

Self-reported~134 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · redmine-mcp-stdio (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads196Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed12Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Redmine MCP Stdio works

What andrelaptenok/redmine-mcp-stdio MCP server does

andrelaptenok/redmine-mcp-stdio MCP server exposes Redmine operations through the Model Context Protocol. It supports both read and write workflows for issues, projects, and time entries, using the permissions of the Redmine account associated with the API key.

The issue tools cover paginated listing and filtering, complete issue retrieval, creation, field updates, and comments. Issue details can include comments, history, and attachments. Project tools list accessible projects and retrieve project information, versions, and members. Separate tools handle time-entry creation and filtered time-entry listing.

A full-text search tool can search issues, wiki content, news, and other Redmine content. The server also provides the current API user and an enumeration lookup for tracker, status, priority, and activity IDs.

How it works

The server runs locally and communicates with the MCP client over stdio. A client starts it on demand with npx -y redmine-mcp-stdio; npx downloads the package on first use and caches it afterward. Requests are sent to the configured Redmine REST API using the supplied credentials.

Each of the 12 tools includes MCP annotations such as read-only and destructive-operation hints. Clients can use those annotations when deciding whether read-only calls may be approved automatically. Write operations still depend on the Redmine user's permissions to create or edit the relevant records.

Setup and configuration

andrelaptenok/redmine-mcp-stdio MCP server requires REDMINE_URL and REDMINE_API_KEY in the MCP client's environment. The URL should identify the Redmine instance, and the API key must belong to a user allowed to access the required projects and records. For write operations, that user also needs the relevant create or edit permissions.

Add a stdio server entry with npx as the command and -y redmine-mcp-stdio as its arguments. The README provides configuration examples for Cursor, VS Code, Claude Code, Claude Desktop, Codex CLI, Windsurf, Cline, Zed, and JetBrains AI Assistant. A local check can also launch the same command directly with both environment variables set.

The documented runtime requirement is Node.js 20 or newer. Keep the API key out of source control; the project recommends using an environment file for local development rather than committing credentials.

Tools and capabilities

The available tools are:

  • list_issues for filtered, paginated issue lists.
  • get_issue for issue details, journals, and attachments.
  • create_issue and update_issue for issue changes.
  • add_comment for adding issue notes.
  • list_projects and get_project for project data.
  • log_time and list_time_entries for time tracking.
  • search for Redmine full-text search.
  • list_enumerations for IDs used by issue and time-entry fields.
  • get_current_user for the account represented by the API key.

The andrelaptenok/redmine-mcp-stdio MCP server accepts filters such as project, status, assignee, date range, issue, user, and content type, depending on the tool. Issue updates can change fields including subject, status, priority, assignee, completion percentage, and notes.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Redmine MCP Stdio

andrelaptenok/redmine-mcp-stdio is an MCP server that connects AI clients to Redmine through stdio. Its main tools list, search, create, and update issues; inspect projects; add comments; log and list time entries; retrieve enumerations; and identify the API user. It uses a configured Redmine URL and API key.

Install it by configuring your MCP client to run `npx -y redmine-mcp-stdio`. No manual package installation is required; npx downloads the package on first launch and caches it. Set `REDMINE_URL` and `REDMINE_API_KEY` in the client's environment, and use Node.js 20 or newer.

Yes, andrelaptenok/redmine-mcp-stdio works with Cursor through its MCP configuration. Add a server entry to the global or project `.cursor/mcp.json`, use `npx` with `-y redmine-mcp-stdio`, provide both Redmine environment variables, then reload Cursor and enable the server.

It needs a valid Redmine API key from a user who can view the required data. Creating or editing issues also requires the corresponding Redmine permissions. If the REST API is disabled, a Redmine administrator must enable it in Administration > Settings > API.

Related MCP servers

All in Product Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRedmine MCP Stdio AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/andrelaptenok-redmine-mcp-stdio?style=directory)](https://allmcps.com/mcp/andrelaptenok-redmine-mcp-stdio)
HTML Embed
<a href="https://allmcps.com/mcp/andrelaptenok-redmine-mcp-stdio"><img src="https://allmcps.com/api/badge/andrelaptenok-redmine-mcp-stdio?style=directory" alt="Redmine MCP Stdio on AllMCPs" /></a>