# MakeHybrid MCP server

> Integrates LinkedIn, messaging channels, and work trackers from a MakeHybrid account into AI clients like Gemini CLI.

- Repository: https://github.com/makehybrid/mcp
- Page: https://hostedmcp.org/servers/makehybrid/mcp
- Transport: stdio, remote
- Stars: 0
- Latest version: 1.1.0

## Install

### Claude Code

```sh
claude mcp add --env 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' mcp -- npx -y makehybrid-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "makehybrid-mcp"
      ],
      "env": {
        "MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "makehybrid-mcp"
      ],
      "env": {
        "MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","makehybrid-mcp"],"env":{"MAKEHYBRID_API_KEY":"<YOUR_MAKEHYBRID_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "makehybrid-mcp"
      ],
      "env": {
        "MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' -- npx -y makehybrid-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "makehybrid-mcp"]

[mcp_servers.mcp.env]
MAKEHYBRID_API_KEY = "<YOUR_MAKEHYBRID_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' mcp npx -- -y makehybrid-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "makehybrid-mcp"
      ],
      "env": {
        "MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MAKEHYBRID_API_KEY` | yes | yes | The organization's MakeHybrid API key, from its dashboard. |
| `MAKEHYBRID_BASE_URL` | no | no | The host to call. Defaults to https://makehybrid.com; white-label customers set their provider's address. |

## Tools (19)

- `makehybrid_list_operations`: Search the MakeHybrid LinkedIn API catalogue (429 operations: 429 MakeHybrid API) and get back a compact table of plan, method, path, group and operation id, plus the total number of matches. Start here, then pass an id to makehybrid_describe_operation or makehybrid_call.
- `makehybrid_describe_operation`: Show one operation in full: method, path, plan, group, required scope, path parameters, summary, the source file it was derived from, and the exact makehybrid_call arguments that invoke it. Use this before calling an operation you have not called before.
- `makehybrid_call`: Invoke ANY operation in the MakeHybrid manifest -- all 429 of them (429 MakeHybrid API). The catalogue is derived from the live API, so an endpoint added upstream becomes callable here as soon as the manifest refreshes, with no new tool. Use makehybrid_list_operations to find the operation id and makehybrid_describe_operation to see its parameters, then call it here. Authentication is handled by the server.
- `makehybrid_status`: Report the configured host, enabled plans, whether an API key is configured (never the key itself), the manifest's origin, digest and age, the operation count per plan, and whether writes are enabled. Use this when a call fails unexpectedly.
- `complete_connect_credentials`: Sign a LinkedIn account in with the member's own email and password. DO NOT ASK ANYONE FOR A PASSWORD IN A CONVERSATION: send them POST /linkedin/connect/link {action: connect} instead, which gives a one-hour link to a page where the password is typed, and which handles every check LinkedIn asks for. This route is for a caller with its own sign-in form. The password is forwarded once and never stored. LinkedIn answers most first sign-ins with a challenge, so a 201 here usually means the account was challenged rather than connected — follow up on POST /linkedin/connect/checkpoint. -- MakeHybrid API plan, POST /linkedin/connect/credentials, group connect.
- `complete_connect_cookie`: Connect an account with an `li_at` session cookie the member took from their own browser. A cookie is a credential: do not ask for one in a conversation — POST /linkedin/connect/link {action: connect} is the way to offer this to a person. Forwarded once, never stored. -- MakeHybrid API plan, POST /linkedin/connect/cookie, group connect.
- `complete_connect_accounts`: The LinkedIn accounts this organization has connected, which are the only ones anything here may act as. Start here when a request names a person's account: an id that is not on this list answers 404 everywhere else. -- MakeHybrid API plan, GET /linkedin/connect/accounts, group connect.
- `complete_linkedin_search_people`: Perform People Search -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/linkedin/search/people, group linkedin.
- `complete_linkedin_search_posts`: Perform Posts Search -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/linkedin/search/posts, group linkedin.
- `complete_users`: Get a User Profile -- MakeHybrid API plan, GET /linkedin/v2/{account_id}/users/{user_id}, group users.
- `complete_chats`: List all Chats -- MakeHybrid API plan, GET /linkedin/v2/{account_id}/chats, group chats.
- `complete_chats_messages_send`: Send a Message -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/chats/{chat_id}/messages/send, group chats.
- `complete_posts`: Create a Post -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/posts, group posts.
- `complete_webhooks_inbox`: Read the AI inbox: what happened on your connected LinkedIn accounts (messages received and sent, new relations, account status changes and checkpoints), in your shared inbox (inbox.* events) and on your X account (x.message_*), oldest first, kept 30 days. Pass query.after = the next value from your last read to see only what is new, query.event to filter, query.since for a time. -- MakeHybrid API plan, GET /linkedin/webhooks/inbox, group webhooks.
- `complete_connect_link`: Get a link to a page for one task, to give the user: connect, reconnect or disconnect a LinkedIn account (they sign in on a secure page that handles every LinkedIn check), create an API key, add a webhook, or set up their own white-label brand. Send action: connect, reconnect, disconnect, key, webhook or brand, plus account_id to reconnect or disconnect. A password, a new key, a signing secret or a payment key stays on that page and never comes back through the chat. The link lasts an hour. Check the outcome with GET /linkedin/connect/link/{handle}. -- MakeHybrid API plan, POST /linkedin/connect/link, group connect.
- `complete_inbox_v1_inboxes`: List the inboxes, one per connected channel: id, name and channel_type (Channel::Whatsapp, Channel::Telegram, Channel::Email, Channel::Sms, Channel::TwilioSms, Channel::Line, Channel::WebWidget, Channel::Api, Channel::Tiktok, Channel::Instagram, Channel::FacebookPage). Use the id as inbox_id elsewhere. -- MakeHybrid API plan, GET /inbox/v1/inboxes, group inbox.
- `complete_inbox_v1_conversations`: List conversations across every channel, newest activity first, 25 a page: query status (open, resolved, pending, snoozed, all), inbox_id (one channel), assignee_type (me, unassigned, assigned, all), labels, q (words in the messages), page. -- MakeHybrid API plan, GET /inbox/v1/conversations, group inbox.
- `complete_inbox_v1_conversations_messages`: Reply in a conversation on the customer's own channel: body {content, message_type: outgoing}. With private: true it is an internal note only your team sees. In an API inbox, message_type incoming records what the customer wrote. -- MakeHybrid API plan, POST /inbox/v1/conversations/{id}/messages, group inbox.
- `complete_x_v1_messages`: Send a message on X to one person: body {to: an X user id or a username such as @pat, text}. Goes to X Chat, encrypted, when you have a conversation there and the passcode was given; otherwise a direct message. -- MakeHybrid API plan, POST /x/v1/messages, group x.

## FAQ

### Can I use this with the Gemini web app?

Yes, you can add it as a custom app on the Connected apps page by pasting the MCP server URL provided in your dashboard.
