Dooray

Dooray API 활용한 MCP 서버

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mskim8717-dooray-mcp": {
      "command": "/Users/yourname/project/.venv/bin/python",
      "args": [
        "/Users/yourname/project/src/dooray-mcp-server.py"
      ],
      "env": {
        "DOORAY_API_KEY": "YOUR_API_KEY",
        "DOORAY_MEMBER_ID": "YOUR_MEMBER_ID",
        "DOORAY_CALENDAR_ID": "YOUR_CALENDAR_ID"
      }
    }
  }
}

Dooray MCP Server uses the Dooray API to manage schedules inside your MCP client workflow. It lets you add events with automatic start and end times, while also carrying location and description details for clear event context.

How to use

You connect your MCP client (such as Claude or Cursor) to this local Python server to create and manage Dooray-based schedules. Run the server, then configure your MCP client to point at the local server’s script so it can send schedule data. When you create or modify events from your client, the server will populate fields like start time, end time, location, and description based on your input and the Dooray API.

How to install

Prerequisites: Python installed on your system. You will also optionally use a virtual environment to isolate dependencies.

Option A — Installing via Smithery (automatic) you can install Dooray Schedule Manager for Claude Desktop automatically via Smithery.

npx -y @smithery/cli install @mskim8717/dooray-mcp --client claude

Option B — Manual Installation (from source) follow these steps to set up the server locally.

# 1. Clone the repository
git clone https://github.com/mskim8717/dooray-mcp.git
cd dooray-mcp

# 2. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# or
.\venv\Scripts\activate  # Windows

# 3. Install dependencies
pip install -e .

Additional configuration and run details

Prepare your MCP client to locate and start the local server. You should point the client to the Python runtime in your virtual environment and to the server script path when you configure the mcp.json file. An example configuration (macOS/Linux paths) is shown for reference.

{
  "mcpServers": {
    "dooray-mcp": {
      "command": "/Users/yourname/project/.venv/bin/python",
      "args": [
        "/Users/yourname/project/src/dooray-mcp-server.py"
      ]
    }
  }
}

Environment variables and startup

Create a configuration file to supply your Dooray credentials and identifiers. The server expects the following variables to access the Dooray API and target the correct calendar.

# Create a .env file in the server project directory
DOORAY_API_KEY=your_api_key
DOORAY_MEMBER_ID=your_member_id
DOORAY_CALENDAR_ID=your_calendar_id

Starting the server

Run the server using the Python script provided in the project.

python src/dooray-mcp-server.py

Project structure

The repository organizes the server code and configuration as follows.

Dooray MCP Server/
├── src/
│   └── dooray-mcp-server.py
├── pyproject.toml
├── README.md
└── LICENSE

License

The project is released under the MIT License.