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:
-
Create a new builder instance (if you haven't already):
docker buildx create --use -
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 . -
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.