Mcp For Redmine

What is Mcp For Redmine?

Mcp For Redmine is a Model-Context-Protocol (MCP) server that lets MCP-compatible clients manage Redmine projects, issues, users, and time entries. It connects to any Redmine instance via its REST API and is intended for developers and administrators who want to interact with Redmine through AI assistants or custom tools.

How to use Mcp For Redmine?

Install and configure the server by adding it as an MCP server in your client (Cursor, Claude Desktop, Claude Code, Gemini CLI, or OpenAI Codex). Provide your Redmine base URL and API key via environment variables (REDMINE_BASE_URL and REDMINE_API_KEY) or CLI flags (--url, --api-key). The server runs via npx -y @chspower1/mcp-for-redmine@latest using stdio transport.

Key features of Mcp For Redmine

• Manage users: create, get, list, update, delete.
• Manage projects: CRUD plus archive/unarchive operations.
• Manage issues: full CRUD with support for custom fields and attachments.
• Manage time entries: list, get, create, update, delete.
• Alpha APIs for memberships, versions, wiki pages, queries, files, attachments, issue relations, and more.
• Pagination and association expansion on list tools.

Use cases of Mcp For Redmine

• Automate issue creation or updates from an AI assistant.
• Retrieve project and user details to answer questions without manual Redmine navigation.
• Synchronize time entries or project data between Redmine and other tools.
• Bulk operations on issues, versions, or wiki pages via natural language commands.

FAQ from Mcp For Redmine

What transport does Mcp For Redmine support?

Currently only stdio (standard input/output) transport is supported.

What are the requirements to run Mcp For Redmine?

Node.js 18 or higher and a Redmine API key. The compatibility baseline is Redmine 6.0.6.

How do I configure the Redmine URL and API key?

You can set REDMINE_BASE_URL (or REDMINE_URL) and REDMINE_API_KEY (or REDMINE_TOKEN) as environment variables, use CLI flags --url and --api-key, or place them in a .env file. For most clients, add them under env in the MCP server config.

Does the server support file attachments?

Yes. Use attachments_upload to upload a Base64 file and get a token, then include the token in the uploads field of issues_create/update or wiki_pages_create_or_update.

What should I do if I see "Redmine URL is required" or authentication errors?

Ensure your URL and API key are correctly set using one of the configuration methods. For security, use environment variables. Verify your API key permissions and network connectivity.