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_issues

List 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_issue

Create a new issue

update_issue

Update an existing issue

delete_issue

Delete an issue

add_issue_watcher

Add a user as a watcher to an issue

remove_issue_watcher

Remove a user from issue watchers

list_projects

List all accessible projects (public and authorized private projects).

  • Include additional data (trackers, categories, etc.)
  • Available since Redmine 1.0
show_project

Get detailed information about a specific project.

  • Retrieve by ID or identifier
  • Include additional related data
  • Available since Redmine 1.0
create_project

Create a new project.

  • Required: name and identifier
  • Optional: modules, trackers, custom fields
  • Available since Redmine 1.0
update_project

Update an existing project.

  • Specify project by ID or identifier
  • Only specified fields will be updated
  • Available since Redmine 1.0
archive_project

Archive a project.

  • Project becomes read-only
  • Available since Redmine 5.0
unarchive_project

Unarchive a previously archived project.

  • Project becomes editable again
  • Available since Redmine 5.0
delete_project

Permanently 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_entries

List 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_entry

Get detailed time entry information.

  • Retrieve a single time entry by ID
  • Available since Redmine 1.1
create_time_entry

Create 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_entry

Update 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_entry

Delete a time entry.

  • Delete a single time entry by ID
  • This action cannot be undone
  • Available since Redmine 1.1
list_users

List users (requires admin privileges). Returns a list of users with filtering options. Available since Redmine 1.1

show_user

Get user details.

  • Use 'current' as ID to get current user details
  • Visible fields depend on user privileges
  • Available since Redmine 1.1
create_user

Create a new user (requires admin privileges). Returns:

  • 201 Created: user was created
  • 422 Unprocessable Entity: validation failed Available since Redmine 1.1
update_user

Update an existing user (requires admin privileges). Returns:

  • 200 OK: user was updated
  • 422 Unprocessable Entity: validation failed Available since Redmine 1.1
delete_user

Delete a user (requires admin privileges).

  • This action cannot be undone
  • Returns 204 No Content on success Available since Redmine 1.1