@a-bonus/redmine-mcp

MCP server for Redmine (issues + time entries) over stdio. Written in TypeScript.

Install

npm install @a-bonus/redmine-mcp
# or
npx @a-bonus/redmine-mcp

For local development:

npm install
npm run build
npm start

Related MCP server: redmine-mcp

Config

The Redmine base URL and API key are passed by the MCP host via CLI flags or environment variables:

• --redmine-url / REDMINE_URL

• --redmine-api-key / REDMINE_API_KEY

Tools

Issues

• list_assigned_issues - List issues assigned to a user

• search_issues - Full-text search across issues

• get_issue - Fetch a single issue by ID

• create_issue - Create a new issue

• update_issue - Update issue status, assignee, and progress

• add_issue_note - Add a comment to an issue

Wiki

• get_project_wiki - Fetch a wiki page's content

• list_wiki_pages - List wiki page titles in a project

Time Entries

• list_time_entries - List logged time entries (requires time_entries plugin)

• get_issue_time_entries - List time entries for a specific issue

• create_time_entry - Log time spent on an issue or project

Registration (Claude Code)

Add to .claude/settings.json:

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["@a-bonus/redmine-mcp"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or for local development:

{
  "mcpServers": {
    "redmine": {
      "command": "node",
      "args": ["/path/to/redmine-mcp-npx/dist/index.js"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Pagination

All list tools (list_assigned_issues, search_issues, list_time_entries, get_issue_time_entries) now support pagination with offset parameter and return pagination metadata:

{
  "issues": [...],
  "total": 150,
  "limit": 25,
  "offset": 0
}

• total: Total number of results

• limit: Items per page

• offset: Current page offset

To get the next page, call again with offset: 25 (or current_offset + limit).

Scripts

• npm run build - Compile TypeScript to JavaScript

• npm run dev - Run with tsx (TypeScript directly, no compilation)

• npm start - Run the compiled server

• npm run format - Format code with Prettier

• npm run format:check - Check code formatting