home / mcp / mcp chatwork server

MCP Chatwork Server

Provides MCP access to Chatwork for reading rooms/messages and performing actions like sending messages and managing tasks.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

The MCP Chatwork Server lets you connect Chatwork with your MCP clients, letting AI agents read chats, fetch messages, send replies, manage tasks, and perform common room actions directly from Chatwork.

How to use

You run a local or remote MCP client that supports MCP servers, then point it at the Chatwork MCP server to access rooms, messages, and actions. With this server you can list rooms you participate in, read messages, send messages, get room members, create and manage tasks, delete messages, and leave rooms. Use the available tools to perform these actions from your AI workflows.

How to install

Prerequisites you must have before installing: - Node.js v18 or higher - A Chatwork API Token

# 1) Clone the server repository
git clone [email protected]:vfa-khuongdv/mcp-chatwork.git
cd mcp-chatwork

# 2) Install dependencies
npm install

# 3) Build the server
npm run build

Configure your environment with your Chatwork API token and start testing or running in your MCP client as described below.

export CHATWORK_API_TOKEN="your_token"
npm start

If you prefer to connect via a client-specific configuration, you can reference one of the following runtime configurations.

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

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

Configuration

The server requires you to set the Chatwork API token for authentication.

Environment variable to set: - CHATWORK_API_TOKEN: Your Chatwork API token.

Security and notes

Keep your API token secret and avoid embedding it in public configurations. Restrict access to the MCP client and server endpoints as appropriate for your environment.

Available tools

list_rooms

Returns a list of Chatwork rooms the user is participating in, including details such as room ID and name.

list_messages

Fetches messages from a specified room. Supports an option to force retrieving the latest messages.

send_message

Sends a message to a specified room on behalf of the agent.

get_room_members

Retrieves the list of members for a given room.

create_task

Creates a task within a Chatwork room and assigns it to one or more users with an optional due date.

get_my_tasks

Lists tasks assigned to the current bot account, with optional filtering by who assigned and by status.

delete_message

Deletes a specific message from a room using the message ID.

complete_task

Marks a task in a room as completed.

leave_room

Leaves the agent from a specified room.