Redmine MCP Server

MCP (Model Context Protocol) server for Redmine, built with TypeScript.

Requirements

• Node.js 18+
• A Redmine instance with REST API enabled
• Redmine API Key

Installation

npm install
npm run build

Configuration

Environment variables:

| Variable | Description | Required | | ----------------- | ----------------------------------------------------- | -------- | | REDMINE_URL | Redmine base URL (e.g. https://redmine.example.com) | Yes | | REDMINE_API_KEY | Redmine API Key | Yes |

Usage with VS Code / Claude Desktop

Add to your MCP configuration file:

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "redmine-server-mcp@latest"]
      "env": {
        "REDMINE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Projects (7)

• list_projects — List projects
• get_project — Project details
• create_project — Create project
• update_project — Update project
• archive_project — Archive project
• unarchive_project — Unarchive project
• delete_project — Delete project

Issues (7)

• list_issues — List issues with filters
• get_issue — Issue details
• create_issue — Create issue
• update_issue — Update issue
• delete_issue — Delete issue
• add_watcher — Add watcher
• remove_watcher — Remove watcher

Users (8)

• list_users — List users
• get_user — User details
• create_user — Create user
• update_user — Update user
• delete_user — Delete user
• get_current_user — Current user
• get_my_account — My account
• update_my_account — Update my account

Time Entries (5)

• list_time_entries — List time entries
• get_time_entry — Details
• create_time_entry — Create
• update_time_entry — Update
• delete_time_entry — Delete

Groups (7)

• list_groups, get_group, create_group, update_group, delete_group
• add_user_to_group, remove_user_from_group

Memberships (5)

• list_project_memberships, get_membership, create_project_membership, update_membership, delete_membership

Versions (5)

• list_project_versions, get_version, create_version, update_version, delete_version

Issue Categories (5)

• list_issue_categories, get_issue_category, create_issue_category, update_issue_category, delete_issue_category

Issue Relations (4)

• list_issue_relations, get_issue_relation, create_issue_relation, delete_issue_relation

Wiki (5)

• list_wiki_pages, get_wiki_page, get_wiki_page_version, create_or_update_wiki_page, delete_wiki_page

News (5)

• list_all_news, list_project_news, get_news, create_news, update_news

Attachments & Files (6)

• get_attachment, update_attachment, delete_attachment, upload_file
• list_project_files, create_project_file

Search (2)

• search, search_in_project

Enumerations (3)

• list_issue_priorities, list_time_entry_activities, list_document_categories

Catalogs (4)

• list_trackers, list_issue_statuses, list_custom_fields, list_queries

Roles (2)

• list_roles, get_role

Journals (1)

• update_journal

Agile Sprints — RedmineUP Agile plugin (7)

Requires the RedmineUP Agile plugin installed in your Redmine instance.

• list_agile_sprints — List sprints of a project
• get_agile_sprint — Sprint details
• create_agile_sprint — Create sprint
• update_agile_sprint — Update sprint
• delete_agile_sprint — Delete sprint
• get_issue_agile_data — Get sprint, story points and position of an issue
• assign_issue_to_sprint — Assign (or remove) an issue to a sprint

Development

npm run dev # Run in development mode
npm test    # Run tests
npm run build # Production build

Architecture

The project follows Clean Architecture:

src/
├── domain/         # Types, interfaces, errors
├── application/    # Services (interfaces) and use cases
└── infrastructure/ # Controllers (HTTP), MCP server, utils

License

MIT