npm package: @akson/mcp-chatsuite
Description: MCP server for ChatSuite WhatsApp automation platform
Author: Akson
Latest version: 1.0.1
Deprecated: Deprecated: no consumers. No longer maintained.

# ChatSuite MCP Server

A Model Context Protocol (MCP) server that provides Claude with access to the ChatSuite WhatsApp automation platform. This server enables Claude to manage WhatsApp sessions, send messages, manage groups, handle business features, and more.

## Features

### Session Management
- Create, list, and manage WhatsApp sessions
- Initialize sessions and generate QR codes
- Reset and delete sessions

### Messaging
- Send text and media messages
- List and search messages
- Delete messages (including "delete for everyone")
- Quote/reply to messages
- Send reactions

### Chat Management
- List and manage chats
- Mark chats as read
- Show typing indicators
- Clear chat history

### Group Management
- Create and manage groups
- Add/remove participants
- Promote/demote admins
- Generate and revoke invite links

### Interactive Messages
- Send button messages
- Send list messages
- Create polls
- Send contacts and locations

### Business Features
- Create and manage product catalogs
- Handle orders
- Request payments
- Send order details

### Status Updates
- Post text, image, and video status updates
- List and manage status updates
- View status viewers

### API Token Management
- Create and manage API tokens
- Set granular permissions
- Revoke tokens

## Installation

### Prerequisites

1. Node.js 18+ installed
2. A ChatSuite account with API access
3. An API token from ChatSuite

### Install from npm

```bash
npm install -g @akson/mcp-chatsuite
```

### Install from source

```bash
git clone https://github.com/yourusername/mcp-chatsuite-server.git
cd mcp-chatsuite-server
npm install
npm run build
npm link
```

## Configuration

### 1. Set Environment Variables

Create environment variables for your ChatSuite credentials:

```bash
export CHATSUITE_API_URL=https://api.chatsuite.akson.ch
export CHATSUITE_API_TOKEN=wa_your_token_here
```

You can also create a `.env` file in your home directory:

```bash
# ~/.env
CHATSUITE_API_URL=https://api.chatsuite.akson.ch
CHATSUITE_API_TOKEN=wa_your_token_here
```

### 2. Configure Claude Desktop

Add the ChatSuite server to your Claude Desktop configuration:

#### macOS
Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "chatsuite": {
      "command": "mcp-chatsuite",
      "env": {
        "CHATSUITE_API_URL": "https://api.chatsuite.akson.ch",
        "CHATSUITE_API_TOKEN": "wa_your_token_here"
      }
    }
  }
}
```

#### Windows
Edit `%APPDATA%\Claude\claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "chatsuite": {
      "command": "mcp-chatsuite",
      "env": {
        "CHATSUITE_API_URL": "https://api.chatsuite.akson.ch",
        "CHATSUITE_API_TOKEN": "wa_your_token_here"
      }
    }
  }
}
```

### 3. Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the ChatSuite server.

## Usage

Once configured, you can use ChatSuite tools in Claude by asking it to:

- "List my WhatsApp sessions"
- "Send a WhatsApp message to +1234567890"
- "Create a new WhatsApp group called 'Team Updates'"
- "Show me unread chats"
- "Create a product catalog for my business"
- "Send a poll asking about meeting times"

## Available Tools

### Session Management
- `chatsuite_health` - Check API health
- `chatsuite_list_sessions` - List all sessions
- `chatsuite_create_session` - Create new session
- `chatsuite_get_session` - Get session details and QR code
- `chatsuite_initialize_session` - Initialize session
- `chatsuite_reset_session` - Reset session
- `chatsuite_delete_session` - Delete session

### Messaging
- `chatsuite_send_message` - Send text or media message
- `chatsuite_list_messages` - List messages with filters
- `chatsuite_delete_message` - Delete message

### Chat Management
- `chatsuite_list_chats` - List chats
- `chatsuite_get_chat` - Get chat details
- `chatsuite_mark_as_read` - Mark chat as read
- `chatsuite_send_typing` - Show typing indicator

### Group Management
- `chatsuite_create_group` - Create group
- `chatsuite_list_groups` - List groups
- `chatsuite_add_participants` - Add participants
- `chatsuite_remove_participant` - Remove participant
- `chatsuite_update_participant_role` - Promote/demote admin

### Interactive Messages
- `chatsuite_send_buttons` - Send button message
- `chatsuite_send_list` - Send list message
- `chatsuite_send_poll` - Send poll
- `chatsuite_send_location` - Send location
- `chatsuite_send_contact` - Send contact
- `chatsuite_send_reaction` - Send reaction

### Business Features
- `chatsuite_create_catalog` - Create product catalog
- `chatsuite_create_order` - Create order
- `chatsuite_request_payment` - Request payment

### Status Updates
- `chatsuite_post_status` - Post status update
- `chatsuite_list_status` - List status updates

### Token Management
- `chatsuite_list_tokens` - List API tokens
- `chatsuite_create_token` - Create API token
- `chatsuite_revoke_token` - Revoke API token

## API Token Permissions

When creating API tokens for use with this MCP server, ensure they have the necessary permissions:

- `messaging:read` - Required for reading messages, chats, and sessions
- `messaging:write` - Required for sending messages and managing sessions

Admin role is required for token management operations.

## Troubleshooting

### Server not connecting

1. Check that your API token is valid
2. Verify the API URL is correct
3. Ensure Claude Desktop is properly restarted
4. Check Claude Desktop logs for errors

### Permission errors

1. Verify your API token has the required permissions
2. For admin operations, ensure your token has admin role
3. Check the ChatSuite dashboard for token status

### Connection issues

1. Check your internet connection
2. Verify the ChatSuite API is accessible
3. Try the health check endpoint directly:
   ```bash
   curl https://api.chatsuite.akson.ch/health
   ```

## Development

### Running locally

```bash
# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build
```

### Testing with Claude Desktop

1. Build the project: `npm run build`
2. Update Claude Desktop config to point to local build:
   ```json
   {
     "mcpServers": {
       "chatsuite-dev": {
         "command": "node",
         "args": ["/path/to/mcp-chatsuite-server/dist/index.js"],
         "env": {
           "CHATSUITE_API_URL": "https://api.chatsuite.akson.ch",
           "CHATSUITE_API_TOKEN": "wa_your_token_here"
         }
       }
     }
   }
   ```

## Security

- Never commit API tokens to version control
- Use environment variables for sensitive data
- Rotate API tokens regularly
- Use tokens with minimal required permissions
- Consider using separate tokens for development and production

## Support

For issues with:
- ChatSuite API: Contact ChatSuite support
- MCP Server: Open an issue on GitHub
- Claude Desktop: Check Anthropic documentation

## License

MIT