# mcp-scrumwise

MCP server that exposes the [Scrumwise API](https://www.scrumwise.com/api.html) as tools. 95 API methods covering projects, backlog items, tasks, sprints, releases, time tracking, and more.

## Usage

```bash
SCRUMWISE_EMAIL="your-email" SCRUMWISE_API_KEY="your-api-key" \
  bun x -y mcp-scrumwise
```

Generate an API key in Scrumwise under **Settings → Your company account → API keys**.

## Tools

All Scrumwise API methods are exposed as individual MCP tools with input schemas and descriptions. No trimming — the full API surface is available.

**Read**

- `getData` — retrieve projects, people, backlog items, etc.
- `getDataVersion` — check if data has changed
- `getTimeEntries` — query time logs
- `getAttachmentFileContents` / `getFileContents`

**Create**

- `addProject`, `addBacklogItem`, `addTask`, `addSprint`, `addRelease`
- `addComment`, `addAttachment`, `addChecklist`, `addMessage`
- `addPerson`, `addTag`, `addTimeEntry`, `addRelationship`

**Update**

- `setBacklogItemName`, `setBacklogItemDescription`, `setBacklogItemEstimate`, etc.
- `setSprintDates`, `setSprintName`, `setReleaseDates`, `setReleaseName`
- `setTaskName`, `setTaskEstimate`, `setTaskAssignedPersonID`
- `setTimeEntryUsedTime`, `setCommentText`
- `setCustomFieldValue`
- 40+ more `set*` methods for every property

**Delete**

- `deleteBacklogItem`, `deleteTask`, `deleteSprint`, `deleteRelease`
- `deleteComment`, `deleteTag`, `deleteTimeEntry`, `deleteRelationship`

**Assign / Move**

- `assignBacklogItemToSprint`, `assignBacklogItemToRelease`, `assignBacklogItemToKanbanBoard`
- `moveBacklogItemToBacklogList`, `moveTaskToBoardColumn`

## Configuration

| Variable            | Required | Description                     |
| ------------------- | -------- | ------------------------------- |
| `SCRUMWISE_EMAIL`   | Yes      | Your Scrumwise user email       |
| `SCRUMWISE_API_KEY` | Yes      | API key from Scrumwise settings |

## Development

```bash
git clone https://github.com/mkh/mcp-scrumwise
cd mcp-scrumwise
bun install
bun run build
SCRUMWISE_EMAIL=x SCRUMWISE_API_KEY=y bun run dist/index.js
```

## License

MIT