Redmine MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
REDMINE_HOSTYesRedmine server URL (e.g., 'https://redmine.example.com')
REDMINE_API_KEYYesAPI key obtained from Redmine user settings

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
list_issuesList Redmine issues with filtering and pagination. - Filter by project, tracker, status, assignee - Custom field filtering with cf_x parameters - Sort results by any field - Include related data (attachments, relations)
create_issueCreate a new issue
update_issueUpdate an existing issue
delete_issueDelete an issue
add_issue_watcherAdd a user as a watcher to an issue
remove_issue_watcherRemove a user from issue watchers
list_projectsList all accessible projects (public and authorized private projects). - Include additional data (trackers, categories, etc.) - Available since Redmine 1.0
show_projectGet detailed information about a specific project. - Retrieve by ID or identifier - Include additional related data - Available since Redmine 1.0
create_projectCreate a new project. - Required: name and identifier - Optional: modules, trackers, custom fields - Available since Redmine 1.0
update_projectUpdate an existing project. - Specify project by ID or identifier - Only specified fields will be updated - Available since Redmine 1.0
archive_projectArchive a project. - Project becomes read-only - Available since Redmine 5.0
unarchive_projectUnarchive a previously archived project. - Project becomes editable again - Available since Redmine 5.0
delete_projectPermanently delete a project. - WARNING: This action cannot be undone - All project data will be deleted - Subprojects will also be deleted - Available since Redmine 1.0
list_time_entriesList time entries. - Filter by user ID, project ID, and date - Search within a date range - Retrieve up to 100 entries - Available since Redmine 1.1
show_time_entryGet detailed time entry information. - Retrieve a single time entry by ID - Available since Redmine 1.1
create_time_entryCreate a new time entry. - Either project_id or issue_id is required - hours is required - activity_id is required unless a default activity is defined - Returns 201 Created on success - Returns 422 Unprocessable Entity on validation failure - Available since Redmine 1.1
update_time_entryUpdate an existing time entry. - Update a single time entry by ID - Only specify fields to be updated - Cannot change project - Returns 204 No Content on success - Returns 422 Unprocessable Entity on validation failure - Available since Redmine 1.1
delete_time_entryDelete a time entry. - Delete a single time entry by ID - This action cannot be undone - Available since Redmine 1.1
list_usersList users (requires admin privileges). Returns a list of users with filtering options. Available since Redmine 1.1
show_userGet user details. - Use 'current' as ID to get current user details - Visible fields depend on user privileges - Available since Redmine 1.1
create_userCreate a new user (requires admin privileges). Returns: - 201 Created: user was created - 422 Unprocessable Entity: validation failed Available since Redmine 1.1
update_userUpdate an existing user (requires admin privileges). Returns: - 200 OK: user was updated - 422 Unprocessable Entity: validation failed Available since Redmine 1.1
delete_userDelete a user (requires admin privileges). - This action cannot be undone - Returns 204 No Content on success Available since Redmine 1.1