MCP.so
Sign In

Unipile MCP ServerVerifiedFeatured

@unipile

Basic information

Transport

Streamable HTTP

Authentication

API Key

Last updated

Category

Developer Tools

Author

unipile

Submitted by

Arnaud

About Unipile MCP Server

Unipile MCP server: LinkedIn MCP (Sales Navigator, Recruiter), WhatsApp, Instagram, Telegram and email MCP for coding agents. Build your LinkedIn, WhatsApp and email API integration from Cursor, Claude Code, Codex.

Connection details

https://developer.unipile.com/mcp?branch=v2.0

Setup

claude mcp add unipile --transport http https://developer.unipile.com/mcp?branch=v2.0

Unipile MCP Server tools

5

Lists all API paths and their HTTP methods with summaries, organized by path. Results can be passed directly into 'get-endpoint'.

Gets detailed information about a specific API endpoint, including security schemes and servers

Performs a deep search through paths, operations, and parameters to discover relevant API endpoints. Use this tool to find specific API capabilities, required parameters, or data models based on search keywords. Results can be passed directly into 'get-endpoint'.

Lists all available OpenAPI specs. Use the title to select a spec.

Executes an API request with a given HAR request object.

Overview

What is Unipile MCP Server?

Unipile MCP Server is a hosted, build-time MCP server that gives coding agents the Unipile API contract for LinkedIn (Classic, Sales Navigator and Recruiter), WhatsApp, Instagram, Telegram, Gmail, Outlook, IMAP and calendars, so they can write and test your integration on your own connected accounts.

Behind it is the Unipile API: one REST API through which your users connect their own LinkedIn, messaging, email and calendar accounts, and your product acts on those accounts with one key. The MCP server is generated from the live OpenAPI spec, so the agent works from real paths, parameters and response shapes. It is used while you build; the code it writes calls the Unipile REST API or the Node.js or Python SDK directly, so your product does not depend on MCP in production. Only repositories under github.com/unipile/* are official.

How to use Unipile MCP Server?

  1. In the Unipile dashboard, connect a test account (LinkedIn, WhatsApp, Gmail and so on), create a Scope for it, then create a scoped Account API key.
  2. Add the server https://developer.unipile.com/mcp?branch=v2.0 to your coding agent with the key in an X-API-KEY header.

The key is optional for reading the API reference; without it the agent can still search endpoints and read schemas. It is required for execute-request. Use a scoped Account API key only: a Global Account API key reaches every account in your application, and a Service API key belongs in your backend. Never commit a key to a shared repository.

Claude Code

claude mcp add --transport http unipile "https://developer.unipile.com/mcp?branch=v2.0" --header "X-API-KEY: YOUR_SCOPED_API_KEY"

Or install the plugin, with the key in the UNIPILE_API_KEY environment variable:

/plugin marketplace add unipile/unipile-mcp
/plugin install unipile@unipile

Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "unipile": {
      "type": "http",
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "YOUR_SCOPED_API_KEY" }
    }
  }
}

Cursor

In ~/.cursor/mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "unipile": {
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "YOUR_SCOPED_API_KEY" }
    }
  }
}

VS Code

In .vscode/mcp.json, which prompts for the key instead of storing it:

{
  "inputs": [
    { "type": "promptString", "id": "unipile_api_key", "description": "Unipile scoped Account API key", "password": true }
  ],
  "servers": {
    "unipile": {
      "type": "http",
      "url": "https://developer.unipile.com/mcp?branch=v2.0",
      "headers": { "X-API-KEY": "${input:unipile_api_key}" }
    }
  }
}

Codex

[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "YOUR_SCOPED_API_KEY" }

The README also has configs for Gemini CLI and Windsurf. For API v1, replace v2.0 with v1.0 in the URL and use your v1 access token as the key.

Key features of Unipile MCP Server

  • One server for LinkedIn, Sales Navigator, Recruiter, WhatsApp, Instagram, Telegram, Gmail, Outlook, IMAP, Google Calendar and Outlook Calendar.
  • No invented endpoints: the tools read the live OpenAPI spec.
  • LinkedIn account types stay distinct, with their own search routes, filters and InMail options for Classic, Sales Navigator and Recruiter.
  • Requests are tested before you commit: execute-request sends the same HTTP call your backend will make, against your own test accounts.
  • One messaging schema across LinkedIn, WhatsApp, Instagram and Telegram, and one email schema across Gmail, Outlook and IMAP.
  • API v2 by default, with v1 still available.

Unipile MCP Server tools

On branch=v2.0 the server exposes five tools:

  • Discovery: search-endpoints searches paths, operations and parameters (for example sales-navigator, inmail or relation-requests); list-endpoints lists every path and method; list-specs lists the available OpenAPI specs.
  • Detail: get-endpoint returns one operation's full request and response schema, security and servers.
  • Execution: execute-request runs a request for real, as a HAR object, against your own accounts.

On branch=v1.0, get-server-variables replaces list-specs.

Use cases of Unipile MCP Server

  • Sales tools: "Build a Sales Navigator lead search screen with seniority and headcount filters, using the Unipile API."
  • Unified inbox: "Sync our users' WhatsApp and LinkedIn conversations into our inbox, with a webhook for new messages."
  • Email sequences: "Add Gmail, Outlook and IMAP sending to our sequences, with replies threaded under the original email."
  • CRM actions: "Add a Connect on LinkedIn button to our contact page that sends an invitation with the rep's note and shows whether it is pending."
  • Recruiting software: "Search Recruiter candidates by skills and save them to a hiring project."

Troubleshooting Unipile MCP Server

  • execute-request fails while search works: reading the reference needs no key, but executing does. Add a scoped Account API key in the X-API-KEY header.
  • Sales Navigator or Recruiter routes fail: the connected LinkedIn account needs a Sales Navigator or Recruiter seat. If a user holds several contracts, list and select one first.
  • Routes do not match your accounts: you may be in the v1 environment. Switch the URL to branch=v1.0 and use your v1 access token.

Frequently asked questions

1

Is there an official LinkedIn MCP server?

LinkedIn does not publish one. Unipile's server is a LinkedIn MCP server for coding agents built on the Unipile LinkedIn API, acting on accounts your users connect within each account's own limits.

2

Does my product need MCP in production?

No. The agent uses MCP to discover and test the API while you build; your product calls the Unipile REST API or an SDK directly.

3

Which API key should I give the MCP client?

A scoped Account API key that only reaches the accounts assigned to one Scope. Do not use a Global Account API key or a Service API key.

4

Is there a WhatsApp, Instagram or Telegram MCP?

Yes, in the same server. They share the messaging routes with LinkedIn messages, and Instagram also has posts, stories and comments.

5

Which coding agents does it work with?

Any client that supports remote MCP over Streamable HTTP with a custom header, including Cursor, Claude Code, Codex, Gemini CLI, VS Code, Windsurf and Claude Desktop.

6

Should I use v1 or v2?

v2, unless your accounts are in the v1 environment.

7

What is the Unipile remote MCP server?

The Unipile remote MCP server is a hosted Model Context Protocol endpoint at https://developer.unipile.com/mcp?branch=v2.0, so AI assistants can connect to it without installing or running anything locally.

8

How do I connect to the Unipile MCP server?

Add the endpoint https://developer.unipile.com/mcp?branch=v2.0 to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

9

Does the Unipile MCP server require authentication?

Yes. Unipile requires an API key — check the official documentation for how to obtain one, then include it in your client's configuration.

10

Which transport does the Unipile MCP server use?

Unipile exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments