# Dooray MCP Server

MCP server for Dooray project management and messenger integration.

## Features

- **Task Management**: Create, list, get, update tasks / Change workflow / Mark as done
- **Comments**: List, add, update, delete comments on tasks
- **Project**: Get project details, list workflows
- **Milestones**: Full CRUD (create, list, get, update, delete)
- **Tags**: Create, list, get tags
- **Templates**: Full CRUD for post templates
- **Members**: Search organization members, manage project members
- **Messenger**: Create channels, send messages, DM, manage channel members

## Installation

```bash
pip install dooray-mcp
```

## Configuration

Create a `.env` file:

```env
DOORAY_API_KEY=your-api-key
```

## Usage

### MCP Server (for Claude Desktop, Cursor, etc.)

```json
{
  "mcpServers": {
    "dooray": {
      "command": "dooray-mcp"
    }
  }
}
```

### CLI

```bash
# Tasks
dooray task list --project-id YOUR_PROJECT_ID
dooray task create --project-id YOUR_PROJECT_ID --subject "New Task"
dooray task set-done TASK_ID --project-id YOUR_PROJECT_ID

# Comments
dooray comment list TASK_ID --project-id YOUR_PROJECT_ID
dooray comment add TASK_ID --project-id YOUR_PROJECT_ID --content "Comment"

# Project & Milestones
dooray project get PROJECT_ID
dooray milestone list --project-id YOUR_PROJECT_ID

# Members & Messenger
dooray member search --name "John"
dooray messenger send --channel-id CH_ID --content "Hello"
```

For full CLI reference, see [docs/tools-reference.md](docs/tools-reference.md).

## MCP Tools (32 tools)

| Domain | Tools | Operations |
|--------|-------|------------|
| Task | 6 | list, get, create, update, set-workflow, set-done |
| Comment | 4 | list, add, update, delete |
| Project | 2 | get, list-workflows |
| Milestone | 5 | list, get, create, update, delete |
| Tag | 3 | list, get, create |
| Template | 5 | list, get, create, update, delete |
| Member | 4 | search, list-project, get-project, add-project |
| Messenger | 6 | list-channels, create-channel, send, dm, join, leave |

For detailed tool documentation, see [docs/tools-reference.md](docs/tools-reference.md).

## Development

```bash
pip install -e ".[dev]"
pytest
```