Integrates LinkedIn, messaging channels, and work trackers from a MakeHybrid account into AI clients like Gemini CLI.
Also known as makehybrid/mcp, makehybrid-mcp
- Stars
- 0
- Tools
- 19
- Downloads, 30 days
- 515
- Latest version
- 1.1.0
- Last commit
- Oct 28, 2026
- License
- —
What is MakeHybrid MCP?
MakeHybrid integrates LinkedIn, messaging channels, and work trackers from a MakeHybrid account into AI clients like Gemini CLI. It exposes 19 tools, such as makehybrid_list_operations, makehybrid_describe_operation, makehybrid_call.
Summary generated from the project's README
About MakeHybrid MCP server
Connecting your LinkedIn profile, messaging channels, and work trackers directly to Gemini CLI allows you to manage professional workflows through a command line interface. This server functions as a local bridge that uses stdio to securely handle your MakeHybrid API key, which is stored in your system keychain rather than in plain text files.
Developers can set this up by installing the extension via the Gemini CLI or by configuring it as a custom app in the Gemini web interface using a remote MCP server URL from the MakeHybrid dashboard. The local implementation is designed specifically to handle authentication securely, as the Gemini CLI does not expand environment variables within URL or header blocks. Once configured, you can interact with your connected accounts using natural language commands to list or manage your professional data.
What you can do with it
- 1Manage LinkedIn connectionsAsk the AI to show you all the LinkedIn accounts currently linked to your MakeHybrid profile.
- 2Access professional work toolsUse your messaging channels and work trackers through a single AI interface.
- 3Configure remote Gemini appsConnect your MakeHybrid tools to the Gemini web application using a custom app URL.
Written from the project's README. Every use case is checked against a quote from it.
How to install MakeHybrid MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall MakeHybrid MCP in Claude Code
$ claude mcp add --env 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' mcp -- npx -y makehybrid-mcpInstall MakeHybrid MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"makehybrid-mcp"
],
"env": {
"MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
}
}
}
}Install MakeHybrid MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"makehybrid-mcp"
],
"env": {
"MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
}
}
}
}Install MakeHybrid MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","makehybrid-mcp"],"env":{"MAKEHYBRID_API_KEY":"<YOUR_MAKEHYBRID_API_KEY>"}}'Install MakeHybrid MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"makehybrid-mcp"
],
"env": {
"MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
}
}
}
}Install MakeHybrid MCP in Codex
$ codex mcp add mcp --env 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' -- npx -y makehybrid-mcpInstall MakeHybrid MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "makehybrid-mcp"] [mcp_servers.mcp.env] MAKEHYBRID_API_KEY = "<YOUR_MAKEHYBRID_API_KEY>"
Install MakeHybrid MCP in Gemini CLI
$ gemini mcp add -s user -e 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' mcp npx -- -y makehybrid-mcpInstall MakeHybrid MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"makehybrid-mcp"
],
"env": {
"MAKEHYBRID_API_KEY": "<YOUR_MAKEHYBRID_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for makehybrid-mcp 1.0.0 in an isolated container with no network and no keys. It answered and listed 19 tools.
MakeHybrid MCP tools 19
Read from the server with tools/listmakehybrid_list_operationsSearch 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_operationShow 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_callInvoke 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_statusReport 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_credentialsSign 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_cookieConnect 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_accountsThe 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_peoplePerform People Search -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/linkedin/search/people, group linkedin.
complete_linkedin_search_postsPerform Posts Search -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/linkedin/search/posts, group linkedin.
complete_usersGet a User Profile -- MakeHybrid API plan, GET /linkedin/v2/{account_id}/users/{user_id}, group users.
complete_chatsList all Chats -- MakeHybrid API plan, GET /linkedin/v2/{account_id}/chats, group chats.
complete_chats_messages_sendSend a Message -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/chats/{chat_id}/messages/send, group chats.
Show all 19 toolsShow fewer tools
complete_postsCreate a Post -- MakeHybrid API plan, POST /linkedin/v2/{account_id}/posts, group posts.
complete_webhooks_inboxRead 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_linkGet 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_inboxesList 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_conversationsList 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_messagesReply 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_messagesSend 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.
Configuration
MAKEHYBRID_API_KEYRequiredSecretThe organization's MakeHybrid API key, from its dashboard.
MAKEHYBRID_BASE_URLThe host to call. Defaults to https://makehybrid.com; white-label customers set their provider's address.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablePass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubMakeHybrid for Gemini CLI
Your MakeHybrid account — LinkedIn, the messaging channels, the work trackers — as tools in Gemini CLI.
gemini extensions install https://github.com/makehybrid/mcp
It asks for your MakeHybrid API key at install and keeps it in your system keychain. The key is on your dashboard at makehybrid.com; leave the address setting empty unless your provider gave you one of its own.
Check it worked:
List my connected LinkedIn accounts.
Using the Gemini app instead?
The app does not run extensions. It takes a remote MCP server as a
custom app on its Connected apps page — open gemini.google.com/apps,
choose Add a custom app, and paste the address your dashboard gives
you as the MCP server URL. Nothing to install, and the same tools.
Why this one runs a local server
Gemini CLI expands ${VAR} inside an extension manifest's env block
only — not inside httpUrl, url or headers. So a remote-URL
extension could not carry your own key, and every install would have to
be edited by hand. Running the published package over stdio lets the
settings block below prompt for the key and keep it out of the file.
Publishing this
The extension gallery indexes public GitHub repositories on its own —
there is no form and no approval. What it needs is this directory at the
ROOT of a public repo, with gemini-extension.json as a top-level file,
and a tagged release.
makehybrid-mcp@1.0.0 is on npm, so npx -y makehybrid-mcp@latest
resolves and this no longer waits on anything.
From a checkout of the monorepo:
cd extensions/gemini
git init -b main
git remote add origin https://github.com/makehybrid/mcp.git
git add -A
git commit -m "MakeHybrid for Gemini CLI"
git push -u origin main
git tag v1.0.0 && git push origin v1.0.0
A separate repo rather than a subfolder of the monorepo, for two reasons: the manifest has to be at the root for the gallery to see it, and the monorepo is private and names a plan that is not public yet. These three files name neither — checked, not assumed.
MakeHybrid MCP questions
How do I add MakeHybrid MCP to Claude Code?
Run claude mcp add --env 'MAKEHYBRID_API_KEY=<YOUR_MAKEHYBRID_API_KEY>' mcp -- npx -y makehybrid-mcp in your terminal. Add --scope user to make it available in every project.
How do I add MakeHybrid MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does MakeHybrid MCP provide?
It exposes 19 tools, including makehybrid_list_operations, makehybrid_describe_operation, makehybrid_call, makehybrid_status, complete_connect_credentials.
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.