Smallforce Smallforce Docs

SmallForce MCP for Claude Desktop

Connect SmallForce to Claude Desktop so Claude can manage your social media, CRM contacts, inbox conversations, Google reviews, and call analytics.

Prerequisites

Setup

1. Open the config file

Open your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %AppData%\Claude\claude_desktop_config.json

If the file doesn’t exist, create it.

2. Add the SmallForce server

Add the SmallForce MCP server to the mcpServers section:

{
  "mcpServers": {
    "smallforce": {
      "url": "https://mcp.smallforcehq.com/mcp",
      "headers": {
        "Authorization": "Bearer sf_sk_live_your_api_key_here"
      }
    }
  }
}

Replace sf_sk_live_your_api_key_here with your actual API key.

3. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see the MCP tools icon (a hammer) in the chat input area, indicating SmallForce tools are available.

Usage

Start a conversation with Claude and ask it to use SmallForce:

"What social media accounts do I have connected?"
"Create a post about our summer sale and schedule it for next Monday at 9am"
"Read my latest inbox messages"
"Show me all Google reviews from this month"
"Create a new CRM contact for John Smith at john@example.com"

Claude will automatically select the right SmallForce tool and show you the results.

Troubleshooting

  • No tools icon: Restart Claude Desktop after saving the config file
  • Config not found: Create the file manually at the path shown above
  • Auth errors: Ensure the API key is correct and the Authorization header format is Bearer sf_sk_live_...
  • Connection failed: Check that the URL is exactly https://mcp.smallforcehq.com/mcp