# MCP Chatwork Server
[](https://www.npmjs.com/package/@duongkhuong/mcp-chatwork)
[](https://opensource.org/licenses/MIT)
This is a Model Context Protocol (MCP) server for [Chatwork](https://www.chatwork.com/). 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:
```bash
git clone git@github.com:vfa-khuongdv/mcp-chatwork.git
cd mcp-chatwork
```
2. Install dependencies:
```bash
npm install
```
3. Build the server:
```bash
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`):
```json
{
"mcpServers": {
"chatwork": {
"command": "node",
"args": ["/path/to/mcp-chatwork/dist/index.js"],
"env": {
"CHATWORK_API_TOKEN": "your_chatwork_api_token"
}
}
}
}
```
or
```json
{
"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):
```bash
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
