Unipile MCP Server

MCP server for using Unipile to access messages across multiple messaging platforms.

Overview

A Model Context Protocol (MCP) server implementation that provides integration with the Unipile messaging platform. This server enables AI models to interact with messages from various messaging platforms (Mobile, Mail, WhatsApp, LinkedIn, Slack, Twitter, Telegram, Instagram, Messenger) through a standardized interface.

For more information about the Model Context Protocol and how it works, see Anthropic’s MCP documentation.

Unipile Subscription

To use the Unipile services, a subscription is required. I am not paid by Unipile to do this; I am simply a user who loves using Unipile because it works effectively. For more details on the subscription and features, visit the Unipile Messaging API page.

Communication Capabilities

With Unipile, you can communicate seamlessly across a wide range of social platforms. This includes popular messaging services such as:

• LinkedIn: Engage with professional contacts, send messages, and manage your LinkedIn interactions directly through the Unipile interface.
• WhatsApp: Send and receive messages, manage chats, and stay connected with your contacts.
• Instagram: Interact with followers, respond to direct messages, and manage your Instagram communications.
• Messenger: Communicate with friends and family through Facebook Messenger.
• Telegram: Access your Telegram chats and messages effortlessly.

Unipile’s integration with these platforms allows for a unified communication experience, making it easier to manage interactions across different services. This is particularly beneficial for users who rely on LinkedIn for professional networking, as it enables them to leverage AI capabilities, such as Claude, to enhance their communication strategies.

Components

Resources

The server exposes the following resources:

• unipile://messages: A dynamic resource that provides access to messages from connected messaging platforms

Example Prompts

• Get all messages from a chat:

  Get all messages from chat ID "chat_123"
  

Tools

The server offers several tools for accessing Unipile data:

Message Management Tools

• unipile_get_chat_messages
  • Retrieve all messages from a specific chat with pagination support
  • Input: chat_id (required), batch_size (optional, default: 100)
  • Returns: Array of message objects

Setup

You’ll need a Unipile DSN and API key. You can obtain these from your Unipile dashboard.

Environment Variables

• UNIPILE_DSN: Your Unipile DSN (e.g. api8.unipile.com:13851)
• UNIPILE_API_KEY: Your Unipile API key

Note: Keep your API key secure and never commit it to version control.

Docker Installation

You can either build the image locally or pull it from Docker Hub. The image is built for the Linux platform.

Supported Platforms

• Linux/amd64
• Linux/arm64
• Linux/arm/v7

Option 1: Pull from Docker Hub

docker pull buryhuang/mcp-unipile:latest

Option 2: Build Locally

docker build -t mcp-unipile .

Run the container:

docker run 
  -e UNIPILE_DSN=your_dsn_here 
  -e UNIPILE_API_KEY=your_api_key_here 
  buryhuang/mcp-unipile:latest

Cross-Platform Publishing

To publish the Docker image for multiple platforms, you can use the docker buildx command. Follow these steps:

1. Create a new builder instance (if you haven’t already):

   docker buildx create --use
   

2. Build and push the image for multiple platforms:

   docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-unipile:latest --push .
   

3. Verify the image is available for the specified platforms:

   docker buildx imagetools inspect buryhuang/mcp-unipile:latest
   

Usage with Claude Desktop

Docker Usage

{
  "mcpServers": {
    "unipile": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UNIPILE_DSN=your_dsn_here",
        "-e",
        "UNIPILE_API_KEY=your_api_key_here",
        "buryhuang/mcp-unipile:latest"
      ]
    }
  }
}

Development

To set up the development environment:

pip install -e .

License

This project is licensed under the MIT License.