Connect HeyCMO to Claude Desktop

Use your AI marketing brain directly from Claude Desktop via MCP.

Prerequisites

• A HeyCMO account (sign up here)
• Your MCP endpoint URL (from your dashboard)
• Your API key (from your dashboard)
• Claude Desktop installed

Step 1: Find Your Config File

Open your Claude Desktop configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

Step 2: Add HeyCMO as an MCP Server

Add the following to your config file. Replace YOUR_CUSTOMER_ID and YOUR_API_KEY with your actual values from the dashboard:

{
  "mcpServers": {
    "heycmo": {
      "url": "https://brain.heycmo.ai/mcp/YOUR_CUSTOMER_ID",
      "headers": {
        "Authorization": "Bearer hcmo_live_YOUR_API_KEY"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop. You should see HeyCMO listed as an available MCP server.

Step 4: Start Using It

Try these prompts in Claude Desktop:

"HeyCMO, what should I post about this week?"

"Run my daily research"

"Create a carousel about [topic]"

"How did my content perform last week?"

"Generate an OG image for my new blog post about [topic]"

Available Tools

Once connected, Claude Desktop has access to all 12 HeyCMO MCP tools:

1. run_research — daily research pipeline
2. run_content_creation — create content with approval
3. resume_workflow — approve/reject pending content
4. run_engagement_check — check and respond to comments
5. run_analytics — generate analytics report
6. run_optimization — run self-optimization loop
7. ask_cmo — ask the CMO agent anything
8. generate_carousel — create branded carousel images
9. generate_reel — create short-form video
10. get_brand_context — view brand profile
11. get_content_calendar — view content plan
12. list_pending_approvals — see what needs approval