jztan avatar

Redmine Mcp Server

jztan/redmine-mcp-server

Brings your Redmine instance into the MCP ecosystem with 45+ tools covering issues, time tracking, wiki pages, file attachments, and project membership. Beyond stock Redmine, it supports RedmineUP plugins like Agile, CRM, Products, and the DMSF document manager. Authentication handles API keys, basic auth, or OAuth2 per-user tokens. Ships with read-only mode, prompt injection boundaries for safe LLM consumption, and a built-in HTTP file server that exposes attachments via expiring UUID URLs. Designed for production with pagination, SSL client certs, and Docker support. If you're running Redmine and want Claude to query sprints, update checklists, or pull CRM contacts without leaving the conversation, this is the bridge.

GitHub stars
91
tools
53
auth
Secret needed
transport
STDIO
env vars
12
last updated
Nov 7, 2026

Tools

53 tools

Public tool metadata for what this MCP can expose to an agent.

list_redmine_projectsList accessible projects (active only unless `filters` asks for more), narrowed server-side and optionally paginated

List accessible projects (active only unless `filters` asks for more), narrowed server-side and optionally paginated

No parameter schema in public metadata yet.

list_project_issue_custom_fieldsList issue custom fields configured for a project

List issue custom fields configured for a project

No parameter schema in public metadata yet.

list_redmine_versionsList versions/milestones for a project

List versions/milestones for a project

No parameter schema in public metadata yet.

manage_redmine_versionCreate, update, or delete a version/milestone

Create, update, or delete a version/milestone

No parameter schema in public metadata yet.

manage_redmine_projectCreate a project, edit its settings, or close and reopen it

Create a project, edit its settings, or close and reopen it

No parameter schema in public metadata yet.

list_project_membersList members and roles of a project

List members and roles of a project

No parameter schema in public metadata yet.

summarize_project_statusGet comprehensive project status summary

Get comprehensive project status summary

No parameter schema in public metadata yet.

list_redmine_rolesList all roles defined in the Redmine instance (for discovering valid `role_ids`)

List all roles defined in the Redmine instance (for discovering valid `role_ids`)

No parameter schema in public metadata yet.

get_project_modulesRetrieve the enabled modules for a project

Retrieve the enabled modules for a project

No parameter schema in public metadata yet.

manage_project_memberAdd, update, or remove a project membership

Add, update, or remove a project membership

No parameter schema in public metadata yet.

get_redmine_issueRetrieve detailed issue information (supports journal pagination, watchers, relations, children)

Retrieve detailed issue information (supports journal pagination, watchers, relations, children)

No parameter schema in public metadata yet.

list_redmine_issuesList issues with flexible filtering (project, status, assignee, etc.)

List issues with flexible filtering (project, status, assignee, etc.)

No parameter schema in public metadata yet.

search_redmine_issuesSearch issues by text query

Search issues by text query

No parameter schema in public metadata yet.

create_redmine_issueCreate new issues, with optional file attachments via the `uploads` parameter

Create new issues, with optional file attachments via the `uploads` parameter

No parameter schema in public metadata yet.

update_redmine_issueUpdate existing issues, with optional file attachments via the `uploads` parameter (combine with `notes` to attach files to a journal note)

Update existing issues, with optional file attachments via the `uploads` parameter (combine with `notes` to attach files to a journal note)

No parameter schema in public metadata yet.

delete_redmine_issueHard-delete an issue with required confirmation flags and a cascade-impact preview before irreversible deletion.

Hard-delete an issue with required confirmation flags and a cascade-impact preview before irreversible deletion.

No parameter schema in public metadata yet.

copy_issueDuplicate an existing issue with optional field overrides

Duplicate an existing issue with optional field overrides

No parameter schema in public metadata yet.

list_subtasksList subtasks (child issues) of a given parent

List subtasks (child issues) of a given parent

No parameter schema in public metadata yet.

get_private_notesRetrieve private notes on an issue

Retrieve private notes on an issue

No parameter schema in public metadata yet.

manage_issue_relationList, create, or delete issue relations

List, create, or delete issue relations

No parameter schema in public metadata yet.

manage_issue_watcherAdd or remove a watcher on an issue

Add or remove a watcher on an issue

No parameter schema in public metadata yet.

manage_issue_noteEdit a journal note's text or toggle its privacy

Edit a journal note's text or toggle its privacy

No parameter schema in public metadata yet.

manage_issue_categoryList, create, update, or delete issue categories

List, create, update, or delete issue categories

No parameter schema in public metadata yet.

list_time_entriesList time entries with filtering by project, issue, user, and date range

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

No parameter schema in public metadata yet.

manage_time_entryCreate or update a time entry (use `user_id` to log on behalf of another user)

Create or update a time entry (use `user_id` to log on behalf of another user)

No parameter schema in public metadata yet.

list_time_entry_activitiesDiscover available activity types for time entries

Discover available activity types for time entries

No parameter schema in public metadata yet.

import_time_entriesBulk import time entries via sequential API calls with per-entry error reporting

Bulk import time entries via sequential API calls with per-entry error reporting

No parameter schema in public metadata yet.

list_redmine_trackersList all trackers (Bug, Feature, Support, etc.)

List all trackers (Bug, Feature, Support, etc.)

No parameter schema in public metadata yet.

list_project_trackersList the trackers enabled for a specific project

List the trackers enabled for a specific project

No parameter schema in public metadata yet.

list_redmine_issue_statusesList all issue statuses with their `is_closed` flag

List all issue statuses with their `is_closed` flag

No parameter schema in public metadata yet.

list_redmine_issue_prioritiesList all priority levels

List all priority levels

No parameter schema in public metadata yet.

list_redmine_usersFilter/list users (admin-only; supports name and group filters)

Filter/list users (admin-only; supports name and group filters)

No parameter schema in public metadata yet.

get_current_userGet the authenticated user's profile (works for non-admins)

Get the authenticated user's profile (works for non-admins)

No parameter schema in public metadata yet.

list_redmine_queriesList saved custom queries (read-only)

List saved custom queries (read-only)

No parameter schema in public metadata yet.

search_entire_redmineGlobal search across issues and wiki pages (Redmine 3.3.0+)

Global search across issues and wiki pages (Redmine 3.3.0+)

No parameter schema in public metadata yet.

manage_redmine_wiki_pageList, get, create, update, delete, or rename wiki pages

List, get, create, update, delete, or rename wiki pages

No parameter schema in public metadata yet.

list_redmine_newsList news, optionally for one project

List news, optionally for one project

No parameter schema in public metadata yet.

get_redmine_newsRead one news item with its comments and attachments

Read one news item with its comments and attachments

No parameter schema in public metadata yet.

manage_redmine_newsCreate or update a news item (Redmine 4.1+)

Create or update a news item (Redmine 4.1+)

No parameter schema in public metadata yet.

delete_redmine_newsDelete a news item, with confirmation (Redmine 4.1+)

Delete a news item, with confirmation (Redmine 4.1+)

No parameter schema in public metadata yet.

list_filesList files uploaded to a project's Files section

List files uploaded to a project's Files section

No parameter schema in public metadata yet.

create_upload_ticketReserve an upload slot and return a single-use URL, so a file on the caller's machine reaches the server without its bytes passing through the model

Reserve an upload slot and return a single-use URL, so a file on the caller's machine reaches the server without its bytes passing through the model

No parameter schema in public metadata yet.

upload_fileUpload a new file to a project (from a staged `upload_id`, a URL, base64 content, or a server-side `file_path`), optionally tied to a version

Upload a new file to a project (from a staged `upload_id`, a URL, base64 content, or a server-side `file_path`), optionally tied to a version

No parameter schema in public metadata yet.

delete_fileDelete a file from a project

Delete a file from a project

No parameter schema in public metadata yet.

get_redmine_attachmentDownload an attachment (works in both HTTP and stdio mode)

Download an attachment (works in both HTTP and stdio mode)

No parameter schema in public metadata yet.

get_gantt_chartRetrieve project timeline data: issues with dates, dependencies, and milestones

Retrieve project timeline data: issues with dates, dependencies, and milestones

No parameter schema in public metadata yet.

show_triage_boardRender a project's issues as an interactive Kanban board grouped by status, with drag-to-change-status write-back

Render a project's issues as an interactive Kanban board grouped by status, with drag-to-change-status write-back

No parameter schema in public metadata yet.

get_triage_board_dataBoard data source backing the board's Refresh action

Board data source backing the board's Refresh action

No parameter schema in public metadata yet.

show_project_dashboardRender a live project snapshot (open/closed, overdue, due this week, open-by-priority, recent activity) as an interactive dashboard, with click-through drill-ins to matching issue lists

Render a live project snapshot (open/closed, overdue, due this week, open-by-priority, recent activity) as an interactive dashboard, with click-through drill-ins to matching issue lists

No parameter schema in public metadata yet.

get_project_dashboard_dataApp-only data source backing the dashboard's Refresh action

App-only data source backing the dashboard's Refresh action

No parameter schema in public metadata yet.

show_project_timelineRender a project's schedule as an interactive timeline: issue bars by version, milestone diamonds, and a Today line

Render a project's schedule as an interactive timeline: issue bars by version, milestone diamonds, and a Today line

No parameter schema in public metadata yet.

get_project_timeline_dataApp-only data source backing the timeline's Refresh action

App-only data source backing the timeline's Refresh action

No parameter schema in public metadata yet.

get_mcp_server_infoReport server version, auth mode, read-only state, the authenticated user (`current_user`), and which plugin-gated tool families are enabled. Use to detect deployment lag before relying on a recently-shipped fix, or to confirm who `assigned_to_id="me"` resolves to.

Report server version, auth mode, read-only state, the authenticated user (`current_user`), and which plugin-gated tool families are enabled. Use to detect deployment lag before relying on a recently-shipped fix, or to confirm who `assigned_to_id="me"` resolves to.

No parameter schema in public metadata yet.

Sponsors

Configuration

REDMINE_URL*

URL of your Redmine server (e.g., https://your-redmine-server.com)

REDMINE_USERNAME

Redmine username for authentication (alternative to API key)

REDMINE_PASSWORDsecret

Redmine password for authentication (alternative to API key)

REDMINE_API_KEYsecret

Redmine API key for authentication (alternative to username/password)

SERVER_HOSTdefault: 0.0.0.0

Host address for the MCP server (default: 0.0.0.0)

SERVER_PORTdefault: 8000

Port for the MCP server (default: 8000)

PUBLIC_HOSTdefault: localhost

Public hostname for file download URLs (default: localhost)

PUBLIC_PORTdefault: 8000

Public port for file download URLs (default: 8000)

ATTACHMENTS_DIRdefault: ./attachments

Directory for storing downloaded attachments (default: ./attachments)

AUTO_CLEANUP_ENABLEDdefault: true

Enable automatic cleanup of expired files (default: true)

CLEANUP_INTERVAL_MINUTESdefault: 10

Interval between cleanup runs in minutes (default: 10)

ATTACHMENT_EXPIRES_MINUTESdefault: 60

Default expiry time for attachments in minutes (default: 60)

Readme

Details

Repository
github.com/jztan/redmine-mcp-server
Package
redmine-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from jztan