Blowhorn MCP server

Blowhorn is an AI-native social media manager. This repo holds the small launcher that starts Blowhorn's MCP server, and every marketplace listing file for it. The MCP server itself ships inside the Blowhorn desktop app and runs locally on your Mac over stdio, so its tools always match the Blowhorn you have installed.

• One tool per Blowhorn command, grouped Act, Manage, Connect, Run, Observe and Meta. From Blowhorn 1.62.0, risky tools are hidden by default because each removes or replaces your install, removes a background service or LaunchAgent, or signs you out: uninstall, service_uninstall, auth_logout, desktop_build and desktop_install, and after Blowhorn 1.84.0 also service_adopt and chrome_attach_chrome_uninstall_agent. To serve one, name it with --allow-hidden-tool (repeatable) or in BLOWHORN_MCP_ALLOW_HIDDEN_TOOLS; see Hidden tools.
• Dry run first: reads run as asked. Every state change runs as a dry run unless the call confirms it.
• Approval mode applies: when it is on, work an agent confirms waits for you to approve it in the Blowhorn app.
• No secrets: tool results never carry secrets, and tool arguments are never logged.

Reference: https://blowhorn.ai/docs/reference/mcp-server/

Requirements

• macOS.
• Blowhorn 1.61.0 or later, from https://blowhorn.ai/download/.
• Open Blowhorn once. On first run it writes ~/.local/bin/blowhorn-mcp, the command every MCP client below starts.

Install

Every client starts ~/.local/bin/blowhorn-mcp as a stdio server. Step by step for each client: https://blowhorn.ai/docs/how-to/set-up/connect-mcp-client/. What the server does: https://blowhorn.ai/docs/reference/mcp-server/.

Claude Code

claude mcp add blowhorn -- ~/.local/bin/blowhorn-mcp

Or install it as a Claude Code plugin from this repo, which also adds the Blowhorn skill:

/plugin marketplace add blowhorn-ai/blowhorn-mcp
/plugin install blowhorn@blowhorn

Claude Desktop

In ~/Library/Application Support/Claude/claude_desktop_config.json, with your own user name in place of YOU (Claude Desktop does not expand ~):

{
  "mcpServers": {
    "blowhorn": {
      "command": "/Users/YOU/.local/bin/blowhorn-mcp"
    }
  }
}

Cursor

In ~/.cursor/mcp.json (Cursor interpolates ${userHome}):

{
  "mcpServers": {
    "blowhorn": {
      "command": "${userHome}/.local/bin/blowhorn-mcp"
    }
  }
}

This repo is also a Cursor plugin (.cursor-plugin/plugin.json and mcp.json), which adds the Blowhorn skill as well.

VS Code

In your workspace's .vscode/mcp.json:

{
  "servers": {
    "blowhorn": {
      "type": "stdio",
      "command": "${userHome}/.local/bin/blowhorn-mcp"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/blowhorn-ai/blowhorn-mcp

The extension runs this repo's own launcher with node, which then starts ~/.local/bin/blowhorn-mcp. Gemini CLI fills in only ${extensionPath}, ${workspacePath} and ${/} in an extension manifest, never ${HOME}, so the extension cannot name ~/.local/bin/blowhorn-mcp directly; Gemini CLI itself runs on Node, so node is always there.

Cline

Follow llms-install.md. Cline does not expand ~, so it needs the absolute path /Users/<you>/.local/bin/blowhorn-mcp.

npm

The launcher is published on npm as blowhorn-mcp and in the official MCP Registry as io.github.blowhorn-ai/blowhorn, so any client can start the server with:

npx -y blowhorn-mcp

In a client's JSON config, that is "command": "npx" with "args": ["-y", "blowhorn-mcp"]; on Claude Code it is claude mcp add blowhorn -- npx -y blowhorn-mcp.

... View full README on GitHub