README.md
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
pip install dooray-mcp
Configuration
Create a .env file:
DOORAY_API_KEY=your-api-key
Usage
MCP Server (for Claude Desktop, Cursor, etc.)
{
"mcpServers": {
"dooray": {
"command": "dooray-mcp"
}
}
}
CLI
# 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.
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.
Development
pip install -e ".[dev]"
pytest
Tools 5
task_listList tasks for a specific projecttask_createCreate a new task in a projectcomment_addAdd a comment to a specific taskmessenger_sendSend a message to a specific channelmilestone_listList milestones for a projectEnvironment Variables
DOORAY_API_KEYrequiredAPI key for authenticating with the Dooray serviceTry it
→List all open tasks for my current project.
→Create a new task titled 'Review documentation' in the project.
→Add a comment to task ID 123 saying 'This is ready for review'.
→Send a message to the general channel saying 'Daily standup starting now'.
→Show me all upcoming milestones for the current project.