# Redmine MCP

This is a simple MCP server designed for the Redmine Project Management Software.

It was built using the MCP SDK.

## Get started

1. Clone the repo
2. Install dependencies:

```bash
bun
```

3. Set up `.env`

```
cp .env.example .env # If it succeeds, configure .env to your liking
```

4. Test-run MCP server using `bun run index.ts`. If it works, continue to next section.

### Adding to Claude Desktop

1. Open Claude Desktop
2. Click ⌘, => Developer => Edit Config => Paste Code Below (after configuring)

```json
{
  "mcpServers": {
    "RedmineMCP": {
      "command": "bun",
      "args": ["run", "/path/to/redmine-mcp-server/index.ts"],
      "env": {
        "REDMINE_API_KEY": "${env:REDMINE_API_KEY}",
        "REDMINE_HOST": "${env:REDMINE_HOST}"
      }
    }
  },
  "globalShortcut": ""
}
```

## Available Tools

Right now, the only available tool is the `list_issues` tool. If you want to have one added, please open an issue, and let us discuss.

Enjoy!