MCP Integrations

Gemini CLI

Connect SocialCRM to Google Gemini CLI as an MCP extension.

Connect SocialCRM to Google's Gemini CLI as an MCP extension. Your Gemini agent gets 21 brand intelligence tools.

Prerequisites

  • Gemini CLI installed
  • Node.js 18+
  • SocialCRM account with API key (get one from Settings > API Keys)

Quick Start

1. Authenticate

npx socialcrm auth sk_live_YOUR_KEY

2. Configure Gemini CLI

npx socialcrm init --gemini

This creates gemini-extension.json with the SocialCRM MCP server config.

3. Restart Gemini CLI

Close and reopen Gemini CLI for the extension to load. The 21 SocialCRM tools should now be available.

What You Can Ask

  • "List my brand profiles"
  • "Get platform metrics for my main brand"
  • "Show recent mentions across all AI platforms"
  • "Run a workflow to optimize my AI visibility"
  • "Check my credit balance"

Config File

The init --gemini command writes gemini-extension.json:

{
  "name": "socialcrm",
  "description": "Brand intelligence tools for AI visibility monitoring",
  "url": "https://socialcrm.com/api/mcp-app",
  "headers": {
    "Authorization": "Bearer sk_live_YOUR_KEY"
  }
}

Troubleshooting

Tools not appearing — Restart Gemini CLI completely. If the issue persists, run npx socialcrm status to verify the CLI can reach the server.

Authentication failed — Run npx socialcrm auth again with a valid API key. Check that the key is active in Settings > API Keys.

Extension not loading — Verify gemini-extension.json exists in the expected location for your Gemini CLI version. Google's extension loading path may vary — check the Gemini CLI docs for the current config directory.