What is Mcp Unipile

mcp-unipile is an MCP server implementation that facilitates access to messages across multiple messaging platforms through the Unipile messaging platform. It allows AI models to interact with messages from various services such as Mobile, Mail, WhatsApp, LinkedIn, Slack, Twitter, Telegram, Instagram, and Messenger via a standardized interface.

Use cases

Use cases for mcp-unipile include managing professional interactions on LinkedIn, responding to customer inquiries via WhatsApp, handling social media communications on Instagram and Messenger, and streamlining communication across all messaging platforms.

How to use

To use mcp-unipile, users need to subscribe to Unipile services. Once subscribed, they can integrate the server with their applications to access and manage messages across different platforms seamlessly.

Key features

Key features of mcp-unipile include seamless communication across multiple social platforms, integration with popular messaging services, and the ability to leverage AI capabilities for enhanced communication strategies.

Where to use

mcp-unipile can be used in various fields including business communication, customer support, social media management, and personal messaging, making it suitable for professionals and organizations that rely on multiple messaging platforms.

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.