Mcp Server Redmine

mcp-server-redmine

MCP server for the Redmine REST API. Exposes 32 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:

| 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) |

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 | | redmine_update_issue | ✓ | Update fields on an existing issue | | 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_file | ⚠ | Upload a file to a project |

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](./CONTRIBUTING.md) 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](./SECURITY.md). Do not open a public issue for security problems.

License

[MIT](./LICENSE) © Jesus Reikel Lopez Martin

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jesusr00
• Source: jesusr00/mcp-server-redmine
• License: MIT

Install and usage instructions live in the source repository linked above.