Redmine

Provides an MCP server to interact with Redmine API for tickets, projects, time tracking and more.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vfa-khuongdv-mcp_readmine": {
      "command": "npx",
      "args": [
        "-y",
        "@duongkhuong/mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your_api_key_here",
        "REDMINE_PASSWORD": "your_password",
        "REDMINE_USERNAME": "your_username"
      }
    }
  }
}

You can run an MCP server that lets AI agents interact with Redmine’s API to manage tickets, projects, users, and time entries. This setup provides a type-safe, configurable bridge you can run locally or in your development environment so you can automate Redmine tasks through your preferred MCP client.

How to use

You will run a local MCP server using a lightweight runtime that exposes Redmine interactions as MCP endpoints. Start the server with your MCP client, then issue prompts to list issues, create tickets, log time, or fetch project details. Your client will supply the command and environment variables, and the server will translate your requests into Redmine API calls.

How to install

Prerequisites you need before installing: a modern Node.js runtime and npm. Verify you have Node.js installed by running node -v and npm -v in your terminal.

Install the MCP Redmine server globally so you can run it from any project folder.

Install the MCP Redmine package globally.

Clone the MCP Redmine source, install dependencies, and build the project, then start the server.

Configuration and running tips

Set up the required environment variables before starting the server. You will store these values in your environment or in a local config file that your MCP client can read.

Troubleshooting

If you encounter authentication or connection errors, verify that you provided all required Redmine credentials exactly as shown in your environment configuration. If a tool or endpoint cannot be reached, check that the Redmine URL is correct and that your API key remains valid.

Running standalone for development

npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector npx -y @duongkhuong/mcp-redmine

Available tools

get_issues

Retrieve a list of issues with optional filters such as project, status, assignee, and pagination.

get_issue

Fetch detailed information about a specific issue, including journals and attachments.

get_projects

List all projects accessible in the Redmine instance.

get_project

Get detailed information about a single project by ID.

get_project_members

List members (users) of a given project.

get_project_versions

List versions (milestones) for a specific project.

search_issues

Search issues by keyword across subjects.

create_issue

Create a new issue in a specified project.

update_issue

Update fields of an existing issue.

add_comment

Add a comment to a specific issue.

delete_issue

Delete a specific issue.

log_time

Log time entries for an issue or project.

get_time_entries

List time entries with optional filtering by project, user, and date range.

get_time_entry_activities

List available activities for time logging.

Built by

VeilStrat

AI signals for GTM teams