MCP Chatwork Server

This is a Model Context Protocol (MCP) server for Chatwork. It allows AI agents to read context from Chatwork rooms and messages.

Features

• List Rooms: Retrieve a list of rooms the user is participating in.

• List Messages: Fetch messages from a specific room.

• Send Message: Send a message to a specific room.

• Get Room Members: Get the list of members in a room.

• Create Task: Create a task in a room.

• Get My Tasks: Get the list of tasks assigned to the current bot account.

• Delete Message: Delete a message from a room.

• Complete Task: Mark a task as done.

• Leave Room: Leave a room.

Prerequisites

• Node.js (v18 or higher)

• A Chatwork API Token

Installation

1. Clone the repository:

   git clone git@github.com:vfa-khuongdv/mcp-chatwork.git
   cd mcp-chatwork

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

Configuration

The server requires the CHATWORK_API_TOKEN environment variable to be set.

Usage

With Claude Desktop (or other MCP Clients)

Add the following configuration to your MCP client settings (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "chatwork": {
      "command": "node",
      "args": ["/path/to/mcp-chatwork/dist/index.js"],
      "env": {
        "CHATWORK_API_TOKEN": "your_chatwork_api_token"
      }
    }
  }
}

or

{
  "mcpServers": {
    "chatwork": {
      "command": "npx",
      "args": ["-y", "@duongkhuong/mcp-chatwork"],
      "env": {
        "CHATWORK_API_TOKEN": "your_chatwork_api_token"
      }
    }
  }
}

Manual Testing

You can run the server directly via stdio (though it is designed to communicate with an MCP client):

export CHATWORK_API_TOKEN="your_token"
npm start

Tools

list_rooms

Returns a list of rooms with details like room ID, name, unread count, etc.

list_messages

Returns messages for a given room.

• Arguments:

  • room_id (number): The ID of the room.

  • force (boolean): If true, fetches the latest 100 messages regardless of read status.

send_message

Allows the agent to send messages to a room.

• Arguments:

  • room_id (number): The ID of the room.

  • body (string): The message content.

get_room_members

Get the list of members in a room.

• Arguments:

  • room_id (number): The ID of the room.

create_task

Assign a task to a user in a Chatwork room.

• Arguments:

  • room_id (number): The ID of the room.

  • body (string): The task description.

  • to_ids (array of numbers): List of user IDs to assign the task to.

  • limit (string, optional): Due date in unix time or "YYYY-MM-DD" format.

get_my_tasks

List tasks assigned to the current bot account.

• Arguments:

  • assigned_by_account_id (number, optional): Filter by user ID who assigned the task.

  • status (string, optional): Task status ("open", "done"). Defaults to "open".

delete_message

Delete a message from a room.

• Arguments:

  • room_id (number): The ID of the room.

  • message_id (string): The ID of the message to delete.

complete_task

Mark a task as done.

• Arguments:

  • room_id (number): The ID of the room.

  • task_id (string): The ID of the task.

leave_room

Leave a room.

• Arguments:

  • room_id (number): The ID of the room.

License

MIT