Skip to main content

Claude Desktop

Use SocialAPIs tools in the Claude Desktop app.

Prerequisites​

Setup​

1. Open the config file​

In Claude Desktop, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json:

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

2. Add SocialAPIs​

{
"mcpServers": {
"socialapis": {
"command": "npx",
"args": ["-y", "@socialapis/mcp"],
"env": {
"SOCIALAPIS_API_KEY": "YOUR_API_KEY"
}
}
}
}

Replace YOUR_API_KEY with your key. If the file already has an mcpServers object, add the socialapis entry to it rather than replacing the other servers.

3. Restart Claude Desktop​

Quit Claude Desktop completely and reopen it.

4. Test it​

Ask Claude:

"Get Nike's Facebook page details."

Claude should call the facebook_page tool with action: "details" and show the result. This costs 1 credit.

Example prompts​

Get the latest posts from Nike's Facebook page and summarize them.

Compare follower counts for Adidas and Nike on Instagram.

Analyze the comments on Nike's most recent Facebook post.

Troubleshooting​

Tools don't appear​

  1. Check that the JSON is valid (no trailing commas).
  2. Make sure node --version prints 18 or newer.
  3. Quit and reopen Claude Desktop.
  4. Check the logs: Settings → Developer, then open the log for socialapis.

SOCIALAPIS_API_KEY environment variable or API key argument required​

The key is missing. Add it under env as shown above.

Still stuck?​

Email support@socialapis.io.