dooray-mcp-js

Dooray MCP server implemented in Node.js. It follows the tool names and API behavior of dooray-go/dooray-mcp, but does not require Go or Homebrew.

Requirements

• Node.js 18 or newer

• Dooray personal API token

Related MCP server: gdoc-comments

Official Documentation

• Dooray API official documentation

Scope

This MCP server does not wrap every Dooray API. It focuses on frequently used account, calendar, project, post, attachment, and messenger APIs.

Most /admin/v1 and /admin/v2 administration APIs are intentionally not exposed by default, especially write-capable administration endpoints.

Read-only mode

Dooray personal API tokens are not issued with separate read-only and write permissions. A token that can call write APIs may still have those permissions at the Dooray API level.

For safer installations, this server provides a read-only mode at the MCP tool layer. In read-only mode, write-capable tools are not exposed in tools/list and cannot be called through tools/call.

Run

npx -y dooray-mcp-js --token "{personal-token}"

You can also use an environment variable:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js

Run with only read-only tools exposed:

DOORAY_TOKEN="{personal-token}" npx -y dooray-mcp-js --mode read-only

Codex

Register the package directly with Codex:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js

If the token is not already in DOORAY_TOKEN, pass it when registering:

codex mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

The server reads DOORAY_TOKEN when Codex starts it, so the token does not need to be included in the command arguments.

Codex read-only registration

Register a second MCP server with the same package and token, but expose only read-only tools:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" -- npx -y dooray-mcp-js --mode read-only

You can also set the mode through an environment variable:

codex mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="$DOORAY_TOKEN" --env DOORAY_MCP_MODE=read-only -- npx -y dooray-mcp-js

Claude Desktop

{
  "mcpServers": {
    "dooray-mcp-js": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

Read-only Claude Desktop configuration:

{
  "mcpServers": {
    "dooray-mcp-js-read-only": {
      "command": "npx",
      "args": ["-y", "dooray-mcp-js", "--mode", "read-only"],
      "env": {
        "DOORAY_TOKEN": "{personal-token}"
      }
    }
  }
}

Claude Code

claude mcp add dooray-mcp-js --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js

Read-only registration:

claude mcp add dooray-mcp-js-read-only --env DOORAY_TOKEN="{personal-token}" -- npx -y dooray-mcp-js --mode read-only

Project Structure

dooray-mcp-js/
├── src/
│   └── index.js      # MCP server entry point
├── package.json
└── README.md

Local development

When working from a cloned repository, run the local entry point directly:

DOORAY_TOKEN="{personal-token}" node ./src/index.js

Tools

The dooray-mcp-js package exposes all currently implemented tools. The current server has no delete tool yet.

• dooray_messenger

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_calendar_post_event

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts (lists task posts and fileIdList; list responses may omit the body)

• dooray_post (gets one task including its body with operation=find_post, projectId, and postId)

• dooray_post_logs (find comments and activity logs for a post)

• dooray_post_log (find one comment or activity log by ID)

• dooray_post_log_create (add a comment to a post; body is { "mimeType": "text/x-markdown", "content": "..." })

• dooray_post_log_update (update a comment or activity log with the same body format)

• dooray_post_files (lists regular attachments; an empty result or AUTH_FORBIDDEN_ERROR does not determine whether fileIdList items can be downloaded)

• dooray_post_file_download (downloads IDs from dooray_posts.fileIdList, including inline body images, or regular attachment file IDs with media=raw; authorization is limited to the configured API origin and HTTPS file-api.dooray.com)

• os

Get one task including its body

Call the MCP tool with:

{
  "name": "dooray_post",
  "arguments": {
    "operation": "find_post",
    "projectId": "4271874883715387917",
    "postId": "4406115298695798602"
  }
}

The server calls GET /project/v1/projects/{projectId}/posts/{postId} and returns the Dooray JSON response unchanged. Attachments are returned in result.files (IDs, names, and sizes); list responses can instead contain fileIdList. The title is result.subject; the body text is result.body.content, interpreted according to result.body.mimeType (for example, HTML or Markdown). API errors use the existing MCP error handling. This tool is available in read-only mode. Restart the MCP server and refresh the client tool list after updating the local source; an installation running a published package needs that updated package version.

Reading task URLs and body files

Use this workflow when a request asks for a Dooray task body, an image embedded in the body, or a file referenced by the body. Comments and activity logs are a separate resource and are not required for this workflow.

1. Parse the task URL. /task/{projectId}/{postId} provides both IDs directly. The legacy /project/tasks/{postId} form provides only postId, so its trailing number must not be used as projectId.

2. Resolve the project only for the legacy URL form. Call dooray_project with operation=find_projects and the required type, scope, and state filters. Repeat the relevant filter combinations and continue through page values with size up to 100 until every result page has been checked.

3. For the new URL form, call dooray_post directly using both IDs. For a legacy URL, search for the matching post: call dooray_posts with the project ID from the new URL form or the candidate project IDs discovered for a legacy URL. Use size up to 100, continue through page values as needed, and match the returned post ID to the URL's postId. A lookup under one incorrect project ID or only the first result page is not evidence that the task or its files are unavailable.

4. For a legacy URL, call dooray_post with the matching project and post IDs. Read result.body.content and its format from result.body.mimeType in the detail response. List responses may omit the body. Do not call dooray_post_logs unless the user explicitly asks for comments or activity history.

5. Collect file IDs from the detail response result.files[].id and any fileIdList in the list response, removing duplicates. Call dooray_post_file_download once for each ID using the same verified projectId and postId. These IDs commonly represent images embedded in the task body, but can represent other body files as well.

6. Inspect the returned local filePath with an image viewer or an appropriate document parser. The download result also includes fileName, mimeType, size, and temporary.

dooray_post_files is exposed for listing regular attachments, but it is separate from the fileIdList path used by body files. It can return an empty list or AUTH_FORBIDDEN_ERROR even when direct downloads from dooray_posts.fileIdList work. Therefore, neither outcome should be reported as proof that a body image or file is inaccessible. A fetch failed error or timeout from dooray_post_file_download is also a transport failure, not a permission result, and should be retried or reported separately. Report a file as forbidden or missing only when the direct download returns a terminal Dooray response such as 403 or 404 with the verified projectId, postId, and fileId.

Read-only mode tools

When --mode read-only or DOORAY_MCP_MODE=read-only is set, write-capable Dooray tools are not exposed in tools/list and cannot be called through tools/call.

Exposed in read-only mode:

• dooray_calendar_calendars

• dooray_calendar_events

• dooray_account_members

• dooray_account_member

• dooray_project

• dooray_posts

• dooray_post

• dooray_post_logs

• dooray_post_log

• dooray_post_files

• dooray_post_file_download

• os

Hidden in read-only mode:

• dooray_messenger

• dooray_calendar_post_event

• dooray_post_log_create

• dooray_post_log_update

Options

• --token: Dooray personal API token. Defaults to DOORAY_TOKEN.

• --endpoint: Dooray API endpoint. Defaults to https://api.dooray.com.

• --mode: tool exposure mode. Use full or read-only. Defaults to DOORAY_MCP_MODE or full.