Claude Desktop
Use SocialAPIs tools in the Claude Desktop app.
Prerequisites
- Claude Desktop
- Node.js 18 or newer (
node --version) - A SocialAPIs API key from your dashboard
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
- Check that the JSON is valid (no trailing commas).
- Make sure
node --versionprints 18 or newer. - Quit and reopen Claude Desktop.
- 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.