home / mcp / unipile mcp server

Unipile MCP Server

Provides an MCP interface to access Unipile messages across multiple platforms with unified actions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "honeybluesky-mcp-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"
      ],
      "env": {
        "UNIPILE_DSN": "your_dsn_here",
        "UNIPILE_API_KEY": "your_api_key_here"
      }
    }
  }
}

You deploy this MCP server to connect Unipile with AI models, enabling seamless access to messages from multiple platforms through a single, standardized interface. This makes it simple to fetch conversations, manage chat data, and run cross-platform conversations with AI tooling.

How to use

You use an MCP client to connect to the Unipile MCP server and start querying messages from connected platforms. Look up chats, fetch message history with pagination, and use the results to power AI-driven responses, analytics, or automated workflows. The server exposes a unified access point for platforms like LinkedIn, WhatsApp, Instagram, Messenger, and Telegram through Unipile.

How to install

Prerequisites you need before starting: Docker and a working Docker daemon. You also need a Unipile DSN and a Unipile API key to authorize access to your Unipile data.

Step 1: Install Docker if it is not already installed on your system.

Step 2: Run the Unipile MCP server container using the credentials you obtained from Unipile.

{
  "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"
      ]
    }
  }
}

Additional setup notes

Keep your API key secure and never commit it to version control. You can customize the DSN and API key values in the environment variables shown above.

Configuration and security notes

Environment variables you will configure for the Unipile MCP server are: UNIPILE_DSN and UNIPILE_API_KEY. Use your own DSN and API key provided by Unipile. Ensure these values remain confidential to protect access to your messages.

Tools and capabilities

The server provides a tool to retrieve messages from a chat with pagination support. Name: unipile_get_chat_messages. Description: Retrieve all messages from a specific chat with pagination support. Input: chat_id (required), batch_size (optional, default: 100). Returns: Array of message objects.

Notes

Cross-Platform Publishing: If you need to publish the container image for multiple platforms, use the docker buildx workflow to build and push the image for linux/amd64, linux/arm64, and linux/arm/v7.

Available tools

unipile_get_chat_messages

Retrieve all messages from a specific chat with pagination support. Accepts chat_id and optional batch_size; returns an array of message objects.