Redmine MCP Server

by jztanio.github.jztan/redmine-mcp-serverv2.18.1

MCP server that lets AI assistants manage Redmine issues, projects, wikis, and time tracking

82Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Redmine MCP server

claude mcp add redmine-jztan -e REDMINE_URL='<redmine-url>' -e REDMINE_PASSWORD='<redmine-password>' -e REDMINE_API_KEY='<redmine-api-key>' -- uvx redmine-mcp-server

{
  "mcpServers": {
    "redmine-jztan": {
      "command": "uvx",
      "args": [
        "redmine-mcp-server"
      ],
      "env": {
        "REDMINE_URL": "<redmine-url>",
        "REDMINE_PASSWORD": "<redmine-password>",
        "REDMINE_API_KEY": "<redmine-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "redmine-jztan": {
      "command": "uvx",
      "args": [
        "redmine-mcp-server"
      ],
      "env": {
        "REDMINE_URL": "<redmine-url>",
        "REDMINE_PASSWORD": "<redmine-password>",
        "REDMINE_API_KEY": "<redmine-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "redmine-jztan": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "redmine-mcp-server"
      ],
      "env": {
        "REDMINE_URL": "<redmine-url>",
        "REDMINE_PASSWORD": "<redmine-password>",
        "REDMINE_API_KEY": "<redmine-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "redmine-jztan": {
      "command": "uvx",
      "args": [
        "redmine-mcp-server"
      ],
      "env": {
        "REDMINE_URL": "<redmine-url>",
        "REDMINE_PASSWORD": "<redmine-password>",
        "REDMINE_API_KEY": "<redmine-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
REDMINE_URL	yes	—	URL of your Redmine server (e.g., https://your-redmine-server.com)
REDMINE_USERNAME	—	—	Redmine username for authentication (alternative to API key)
REDMINE_PASSWORD	—	yes	Redmine password for authentication (alternative to API key)
REDMINE_API_KEY	—	yes	Redmine API key for authentication (alternative to username/password)
SERVER_HOST	—	—	Host address for the MCP server (default: 0.0.0.0)
SERVER_PORT	—	—	Port for the MCP server (default: 8000)
PUBLIC_HOST	—	—	Public hostname for file download URLs (default: localhost)
PUBLIC_PORT	—	—	Public port for file download URLs (default: 8000)
ATTACHMENTS_DIR	—	—	Directory for storing downloaded attachments (default: ./attachments)
AUTO_CLEANUP_ENABLED	—	—	Enable automatic cleanup of expired files (default: true)
CLEANUP_INTERVAL_MINUTES	—	—	Interval between cleanup runs in minutes (default: 10)
ATTACHMENT_EXPIRES_MINUTES	—	—	Default expiry time for attachments in minutes (default: 60)

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
2026-10-06 · 4d ago · GitHub · v2.18.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 4d ago · official registry · v2.18.1

FAQ

›How do I install the Redmine MCP server in Claude Code?

Run: claude mcp add redmine-jztan -e REDMINE_URL='<redmine-url>' -e REDMINE_PASSWORD='<redmine-password>' -e REDMINE_API_KEY='<redmine-api-key>' -- uvx redmine-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Redmine require an API key?

Yes. It expects REDMINE_URL, REDMINE_PASSWORD, REDMINE_API_KEY, of which 2 are secrets.

›Can I use Redmine as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Redmine in the official MCP registry?

Yes, as io.github.jztan/redmine-mcp-server.