mcp-server-redmine

MCP server for the Redmine REST API. Exposes 33 tools covering Issues, Issue Relations, Projects, Users, My Account, Time Entries, Wiki Pages, News, Files, Search, and Roles via stdio transport.

Installation

pnpm add mcp-server-redmine

Or use directly via npx:

npx mcp-server-redmine

Configuration

Two environment variables are required, and one is optional:

| Variable | Description | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | REDMINE_URL | Base URL of your Redmine instance, e.g. https://redmine.example.com | | REDMINE_API_KEY | Your Redmine API access key (found in My account → API access key) | | REDMINE_UPLOAD_DIR | Optional. Absolute path; when set, redmine_upload_attachment can only read files inside this directory (symlinks are resolved; hard links and bind mounts are not detected). Recommended to limit what the model can upload. |

Claude Desktop Setup

Add to claude_desktop_config.json:

Note: In Claude Desktop, open Settings → Developer → Edit Config. This opens (or creates) claude_desktop_config.json in your default editor. After saving, fully quit Claude Desktop (not just minimize) and reopen it for the changes to take effect.

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

Claude Code Setup

Run from your project root:

claude mcp add-json redmine '{"command":"npx","args":["mcp-server-redmine"],"env":{"REDMINE_URL":"https://redmine.example.com","REDMINE_API_KEY":"your-api-key"}}'

Or add manually to .mcp.json at the root of your project:

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

Tools

Issues

| Tool | Status | Description | | ---------------------- | ------ | ---------------------------------------------------------------------------------- | | redmine_list_issues | ✓ | List issues with filters: project, status, tracker, assignee, priority, pagination | | redmine_get_issue | ✓ | Get a single issue by numeric ID | | redmine_create_issue | ✓ | Create a new issue in a project, optionally attaching uploaded files | | redmine_update_issue | ✓ | Update fields on an existing issue, optionally attaching uploaded files | | redmine_delete_issue | ✓ | Permanently delete an issue |

Issue Relations

| Tool | Status | Description | | ----------------------- | ------ | ------------------------------------------------------------------------------- | | list_issue_relations | ⚠ | List all relations for a given Redmine issue | | get_issue_relation | ⚠ | Get a single relation by its numeric ID | | create_issue_relation | ⚠ | Create a relation between two issues (relates, blocks, precedes, duplicates, …) | | delete_issue_relation | ⚠ | Permanently delete a relation |

Projects

| Tool | Status | Description | | ------------------------ | ------ | ------------------------------------------------ | | redmine_list_projects | ✓ | List all accessible projects | | redmine_get_project | ✓ | Get a project by identifier (slug) or numeric ID | | redmine_create_project | ✓ | Create a new project | | redmine_update_project | ✓ | Update an existing project |

Users

| Tool | Status | Description | | -------------------------- | ------ | -------------------------------------- | | redmine_list_users | ✓ | List users (requires admin privileges) | | redmine_get_user | ✓ | Get a user by numeric ID | | redmine_get_current_user | ✓ | Get the authenticated user's profile |

My Account

| Tool | Status | Description | | ------------------------ | ------ | ------------------------------------------------------------------------ | | redmine_get_my_account | ⚠ | Get the authenticated user's account details, API key, and custom fields |

Time Entries

| Tool | Status | Description | | --------------------------- | ------ | ---------------------------------------------------------------- | | redmine_list_time_entries | ✓ | List time entries with filters: project, issue, user, date range | | redmine_get_time_entry | ✓ | Get a single time entry by numeric ID | | redmine_log_time | ✓ | Log hours against an issue or project | | redmine_update_time_entry | ✓ | Update an existing time entry | | redmine_delete_time_entry | ✓ | Permanently delete a time entry |

Wiki Pages

| Tool | Status | Description | | -------------------------- | ------ | ----------------------------------------------- | | redmine_list_wiki_pages | ⚠ | List all wiki pages in a project | | redmine_get_wiki_page | ⚠ | Get wiki page content by project and title | | redmine_update_wiki_page | ⚠ | Create or update a wiki page | | redmine_delete_wiki_page | ⚠ | Permanently delete a wiki page (requires admin) |

News

| Tool | Status | Description | | ------------------- | ------ | -------------------------------------------------- | | redmine_list_news | ⚡ | List news articles with optional project filtering |

Files

| Tool | Status | Description | | --------------------------- | ------ | --------------------------------------------------------------------------- | | redmine_list_files | ⚠ | List all files in a project with metadata | | redmine_upload_attachment | ⚠ | Upload a local file and get an attachment token for issues or project files | | redmine_upload_file | ⚠ | Add an already-uploaded file (by token) to a project's Files module |

Search

| Tool | Status | Description | | ---------------- | ------ | ------------------------------------------------------------------------------ | | redmine_search | ⚠ | Search issues, wiki pages, news, documents, changesets, messages, and projects |

Roles

| Tool | Status | Description | | -------------------- | ------ | -------------------------------------- | | redmine_list_roles | ⚠ | List all roles with IDs and names | | redmine_get_role | ⚠ | Get role details including permissions |

API Stability

The tools follow Redmine's API resource stability levels:

| Status | Meaning | | ------------ | ------------------------------------------------------------------------------- | | ✓ Stable | Feature complete, no major changes planned | | ⚠ Alpha | Major functionality in place, needs feedback from integrators | | ⚡ Prototype | Rough implementation, possible breaking changes. Not recommended for production |

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Watch mode
pnpm dev

# Tests
pnpm test

# Type check
pnpm typecheck

Contributing

Contributions are welcome! Please read the Contributing Guide for setup instructions, the project structure, and how to add a new tool. Bug reports and feature requests go through the issue templates.

Security

Found a vulnerability? Please report it privately — see our Security Policy. Do not open a public issue for security problems.

License

MIT © Jesus Reikel Lopez Martin