redmine

This MCP server exposes Redmine functionality to AI assistants through the MCP interface. It provides comprehensive access to Redmine resources such as issues, projects, time tracking, users, and wiki pages, along with utility endpoints to list statuses, priorities, and trackers, and to perform custom API requests. You can interact with these tools by configuring an MCP client (e.g., Claude Desktop, VS Code extensions, or Zed) to connect to this server using the npx-published package address and supplying your Redmine instance URL and API key as environment variables. Once configured, you can ask natural language queries like retrieving open issues assigned to you, listing projects, or updating an issue, and the MCP server will translate those requests into Redmine API calls and return structured results. The available tool set includes: redmine_list_issues, redmine_get_issue, redmine_create_issue, redmine_update_issue, redmine_delete_issue, redmine_list_projects, redmine_get_project, redmine_get_project_versions, redmine_list_users, redmine_get_current_user, redmine_get_user, redmine_list_time_entries, redmine_get_time_entry, redmine_create_time_entry, redmine_update_time_entry, redmine_delete_time_entry, redmine_list_time_entry_activities, redmine_list_wiki_pages, redmine_get_wiki_page, redmine_create_or_update_wiki_page, redmine_delete_wiki_page, redmine_list_statuses, redmine_list_priorities, redmine_list_trackers, redmine_custom_request, and redmine_search.

Prerequisites:

• Node.js >= 20.0.0
• npm (comes with Node.js)
• A Redmine instance with API access enabled and a valid API key

Installation steps:

1. Install the MCP server package globally (recommended): npm install -g @flor3z-github/mcp-server-redmine

2. Run the MCP server directly with npx (no global install required): npx @flor3z-github/mcp-server-redmine

3. Local development workflow (optional):

   • Clone the repository: git clone https://github.com/flor3z-github/redmine-mcp-server.git cd redmine-mcp-server
   • Install dependencies: npm install
   • Build for production (if the project uses a build step): npm run build

Configuration example for a client (Claude Desktop, VS Code, Zed, etc.):

• In your MCP client config, set environment variables: REDMINE_URL=https://your-redmine-instance.com REDMINE_API_KEY=your-api-key
• Configure the MCP server entry to run via npx with the required env vars set in the client configuration.

Note: Always protect your API key and use HTTPS for your Redmine URL. If you cannot use an API key, you can configure REDMINE_USERNAME and REDMINE_PASSWORD as an alternative credential method (not recommended for production).

Environment variables for the Redmine integration include REDMINE_URL and REDMINE_API_KEY as required. Optional variables include REDMINE_USERNAME, REDMINE_PASSWORD, REDMINE_SSL_VERIFY, REDMINE_CA_CERT, REDMINE_REQUEST_TIMEOUT, and REDMINE_MAX_RETRIES to tune client behavior. Ensure your Redmine instance permits API access and that network connectivity between the MCP server and Redmine is available. When using shared environments, avoid committing API keys to version control and prefer per-instance configuration in MCP clients. If you encounter authentication issues, verify that the API key has the appropriate permissions for the requested operations (read/write as needed) and that the Redmine URL is reachable from the MCP host.