Metadata-Version: 2.4
Name: dooray-mcp
Version: 0.2.0
Summary: MCP server for Dooray task and calendar integration
Project-URL: Homepage, https://github.com/kwanok/dooray-mcp
Project-URL: Repository, https://github.com/kwanok/dooray-mcp
Project-URL: Issues, https://github.com/kwanok/dooray-mcp/issues
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

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