Redmine MCP Server
Provides tools for interacting with Redmine, enabling management of projects, issues (create, read, update, add comments), wiki pages, and querying user assignments with filtering capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Redmine MCP Server 오늘 내 일감 정리해줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Redmine MCP Server
An MCP server that lets you work with Redmine in natural language from Claude Code (or any other MCP client). Shipped as a pip package supporting Windows, macOS, and Linux. Works with any self-hosted or corporate Redmine — all you need is an API access key.
⚠️ Your API key and Redmine URL are stored only in
~/.claude.jsonon your own machine. The server runs locally over stdio and never sends your key anywhere.
Provided Tools (10)
Tool | Description |
| List projects |
| List issues (filter by project/assignee/status/date range) |
| Issue details + comments + attachments |
| Create a new issue |
| Add a comment to an issue (can also change status) |
| List wiki pages |
| Read a wiki page |
| Create/update a wiki page |
| Issues assigned to me + recently updated issues (morning briefing) |
| List tracker/status/priority IDs |
Related MCP server: Redmine MCP Server
🚀 Install — Two Lines (Windows · macOS · Linux)
Prerequisites (one-time)
Python 3.10+ (python.org — check "Add to PATH" during install)
pipx(installation guide)Claude Code launched at least once (auto-creates
~/.claude.json)A Redmine API access key (log in to Redmine → top-right "My account" → "API access key")
Install command (recommended: pipx)
pipx install git+https://github.com/junstellar/redmine-mcp-jun.git
redmine-mcp-setupredmine-mcp-setup automatically:
Backs up
~/.claude.json(~/.claude.json.backup.YYYYMMDD_HHMMSS)Prompts for your Redmine server URL + API key (the key is entered as a console password — never logged)
Registers the
mcpServers.redmineentry
Then fully quit and restart Claude Code — the 10 mcp__redmine__* tools become available.
Why pipx?
Installs CLI tools into isolated environments → keeps your system Python clean
Avoids the PEP 668 restriction (Ubuntu 23.04+, Debian 12+, recent Fedora, etc.) where plain
pip installis blockedSame command on every OS
Update / Uninstall
pipx upgrade redmine-mcp # then restart Claude Code
redmine-mcp-uninstall # removes the entry from .claude.json
pipx uninstall redmine-mcpAlternative: plain pip (no pipx)
pip install git+https://github.com/junstellar/redmine-mcp-jun.git
redmine-mcp-setupOn PEP 668-restricted systems, use
pip install --user ...or a virtual environmentIf
pipis missing, trypip3/python3 -m pip
⚡ Non-Interactive Install (automation/batch)
redmine-mcp-setup --url "https://redmine.example.com" --api-key "YOUR_API_KEY" --force🐧 Status by OS
Environment | Status | Notes |
Windows 10/11 + Python 3.10–3.14 | ✅ Verified | Both pip and pipx OK |
macOS (Homebrew Python) | ✅ Works as standard | |
Ubuntu 22.04 (Python 3.10) | ✅ Works as standard | |
Ubuntu 24.04, Debian 12+, recent Fedora/Arch | ⚠️ pipx required | plain |
Ubuntu 20.04 and other Python 3.8 defaults | ⚠️ Python upgrade needed |
|
WSL2 | ✅ Same as Linux |
Common requirements: the Redmine REST API must be enabled (Administration → Settings → API) and the Redmine server must be reachable from your machine. For internal/private-network Redmine, make sure you're on VPN etc.
Usage Examples (inside Claude Code)
Reading
"Summarize my issues for today"
"Show me the issue list for my-project"
"What was issue #123 about?"
"Show issues updated this week"
"Show only in-progress issues assigned to me"
Writing
"Create a new issue 'GPU out of memory' in my-project"
"Comment 'Starting work on this' on #123"
"Change the status of #123 to Closed"
Wiki
"List the wiki pages of my-project"
"Create a 'Getting Started' wiki page in my-project"
Beyond
"Summarize my issues updated yesterday as an email body"
"Count my issues from the past week by status"
Manual Install (register without the setup script)
Install the package
pip install git+https://github.com/junstellar/redmine-mcp-jun.gitAdd to the
mcpServerssection of~/.claude.json:{ "mcpServers": { "redmine": { "command": "python", "args": ["-m", "redmine_mcp"], "env": { "REDMINE_URL": "https://redmine.example.com", "REDMINE_API_KEY": "YOUR_API_KEY_HERE", "PYTHONIOENCODING": "utf-8" } } } }Windows:
%USERPROFILE%\.claude.jsonmacOS/Linux:
~/.claude.json
Restart Claude Code
Project Layout
redmine-mcp/
├─ pyproject.toml # pip package metadata
├─ src/
│ └─ redmine_mcp/
│ ├─ __init__.py
│ ├─ __main__.py # python -m redmine_mcp
│ ├─ server.py # MCP server core (10 tools)
│ └─ installer.py # setup/uninstall scripts
├─ install.ps1 # optional Windows wrapper
├─ uninstall.ps1 # optional Windows wrapper
├─ INSTALL_PROMPT.md # paste-into-Claude-Code auto-install prompt
├─ LICENSE # MIT
└─ README.mdRunning Directly (debug)
It's a stdio-mode server, so running it directly just waits for client input (quit with Ctrl+C).
REDMINE_URL=https://redmine.example.com \
REDMINE_API_KEY=YOUR_KEY \
redmine-mcpWindows PowerShell:
$env:REDMINE_URL="https://redmine.example.com"
$env:REDMINE_API_KEY="YOUR_KEY"
redmine-mcpLicense
MIT — use, modify, and distribute freely. See LICENSE.
Available Tools
11 toolsadd_commentA
이슈에 댓글 추가 (선택적으로 상태 변경).
Args: issue_id: 이슈 번호. note: 댓글 내용 (Markdown 가능). status_id: 함께 변경할 상태 ID (없으면 상태 유지).
Inputs: note (required), issue_id (required), status_id.
create_issueA
새 이슈 생성.
Args: project_id: 프로젝트 식별자 (예: "my-project") 또는 숫자 ID. subject: 제목 (필수). description: 본문 (Markdown 가능). tracker_id: 트래커 ID. list_enumerations() 로 확인. assigned_to_id: 담당자 사용자 ID. priority_id: 우선순위 ID. parent_issue_id: 상위 이슈 ID. start_date: 시작일 "YYYY-MM-DD". due_date: 마감일 "YYYY-MM-DD".
Inputs: subject (required), project_id (required), due_date, start_date, +5 more.
download_attachmentA
첨부파일 다운로드 (이미지 인라인 표시).
get_issue 결과의 attachments[].id 를 넘기면 이미지인 경우 대화창에 바로 렌더링됨. 이미지가 아닌 첨부파일은 에러 — content_url 을 브라우저로 직접 열어주세요.
Args: attachment_id: 첨부파일 ID.
Inputs: attachment_id (required).
get_issueA
이슈 상세 조회 (본문 + 댓글 + 첨부파일).
Args: issue_id: 이슈 번호 (예: 123). include_comments: 댓글 포함 여부 (기본 True).
Inputs: issue_id (required), include_comments.
get_my_todayA
오늘 봐야 할 일감 한 번에 조회.
my_open_issues: 나에게 할당된 미완료 일감
recently_updated: 최근 2일 이내 갱신된 내 일감
매일 아침 알림 스크립트에서 호출하기 좋게 구조화됨.
Inputs: no named parameters.
get_wikiC
위키 페이지 내용 조회.
Args: project_id: 프로젝트 식별자. page_name: 페이지 제목.
Inputs: page_name (required), project_id (required).
list_enumerationsA
이슈 생성/필터링에 필요한 ID 목록.
trackers: 트래커 (개발/버그/작업 등)
statuses: 상태 (신규/진행/종료 등)
priorities: 우선순위 (낮음/보통/높음 등)
Inputs: no named parameters.
list_issuesA
일감 목록 조회.
Args: project_id: 프로젝트 식별자 (예: "my-project"). 비우면 전체. assigned_to: 담당자 ID 또는 "me" (본인). status: "open"(기본), "closed", "*"(전체) 또는 상태 ID. updated_within_days: 최근 N일 이내 갱신된 일감. tracker_id: 트래커 ID 필터. limit: 최대 개수 (기본 25, 최대 100). sort: 정렬 키 (기본 "updated_on:desc").
Inputs: sort, limit, status, project_id, +3 more.
list_projectsB
Redmine 프로젝트 목록 조회 (식별자, 이름, 설명).
Inputs: no named parameters. Returns: result
list_wiki_pagesC
프로젝트의 위키 페이지 목록.
Args: project_id: 프로젝트 식별자.
Inputs: project_id (required). Returns: result
update_wikiA
위키 페이지 생성/수정 (없으면 생성, 있으면 수정).
Args: project_id: 프로젝트 식별자. page_name: 페이지 제목. text: 본문 (Textile 또는 Markdown). comment: 수정 사유. parent_title: 상위 페이지 제목 (계층 구조).
Inputs: text (required), page_name (required), project_id (required), comment, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
All tools have clearly distinct purposes: add_comment is for issue comments, create_issue for creation, download_attachment for downloading, get_issue for details, get_my_today for personalized summary, get_wiki for wiki content, list_enumerations for IDs, list_issues for listing, list_projects for projects, list_wiki_pages for wiki listing, and update_wiki for wiki modification. No two tools overlap in functionality.
Tool names follow a consistent snake_case verb_noun pattern (e.g., create_issue, list_projects). The only minor deviation is 'get_my_today' which uses a possessive 'my_today', but it remains readable and fits the pattern of other 'get_' tools.
With 11 tools covering issues, wiki, projects, attachments, and enumerations, the number is well-scoped. Each tool earns its place without redundancy, appropriate for a Redmine MCP server.
Core operations for issues (create, read, add comment) and wiki (get, list, upsert) are present, but missing update and delete for issues, and delete for wiki. This leaves notable gaps in lifecycle coverage, though the surface handles common workflows.
Maintenance
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Create projects, nodes, and tasks in UluP Spaces by conversation with Claude.
Share one project context across ChatGPT, Claude, Telegram and any MCP client.
Related MCP Servers
- AlicenseBqualityCmaintenanceA Model Context Protocol server that enables Claude Code to directly interact with Redmine project management systems, supporting issue management, project operations, and search features.229MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to interact with Redmine project management systems, providing comprehensive access to issues, projects, time tracking, users, and wiki pages through natural language commands.3359 npm1Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Redmine project management systems through MCP tools, providing access to issues, projects, time tracking, wiki, and more.569 PyPI92MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3325 npm6Apache 2.0