# 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
```
