Prerequisites
- A WoopSocial account
- A connected social media account on WoopSocial
- Access to the AI Agent/AI Chat/CLI you want to configure
Select your AI tool or Agent
Claude (web, Desktop, Cowork)
WoopSocial is listed in Claude’s Connectors Directory as a Community connector. You don’t need an API key or an MCP URL.- Open the WoopSocial connector in Claude’s Connectors Directory and add it to Claude. If you aren’t signed in to Claude, you’ll be asked to sign in first.
- Read the notice Claude shows for Community connectors, then continue
- Sign in to WoopSocial, or create a free account, and click Authorize
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- Start a new Chat in Claude. If WoopSocial isn’t turned on, click + → Connectors and toggle it on
- Ask Claude to write a test post to your social account for tomorrow
- It will find your Project ID and Social Account ID and will schedule a test post for tomorrow
- If you want, you can delete the post straight away
woopsocial, use https://api.woopsocial.com/mcp as the URL and follow the prompts. On Team and Enterprise plans, an owner adds connectors in Organization settings → Connectors.
Note: Text posts work in any chat. To upload images and videos from a chat, Claude needs code execution turned on and access to *.r2.cloudflarestorage.com (including the asterisk/star), where your media is stored. You can set both in Settings → Capabilities, in the code execution network settings.
Issues? Just use the chat button in the bottom right and we’ll help you out.
Claude Code CLI
If you added the Claude connector and sign in to Claude Code with the same Claude account, WoopSocial is already available. Type/mcp in Claude Code to check.
Otherwise, use the claude mcp add command to register WoopSocial with Claude Code.
- Ensure that you have a WoopSocial account and you are logged in
- Connect a social media account through your WoopSocial dashboard
- Start
claude - In Claude, type
/mcp - Select the
woopsocial · △ needs authenticationmenu item - Select
Authenticate - This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
- Return to Claude
- Ask Claude to do something with the MCP. For example tell it to “List my social accounts in woopsocial” or “Create a new post for my Facebook account and schedule it for tomorrow 1pm”
Codex CLI
- Ensure that you have a WoopSocial account and you are logged in
- Connect a social media account through your WoopSocial dashboard
- Use the
codex mcp addcommand to register WoopSocial with Codex.
- This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
- Ask Codex to do something with the MCP. For example tell it to “List my social accounts in woopsocial” or “Create a new post for my Facebook account and schedule it for tomorrow 1pm”
ChatGPT
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- Now go to your ChatGPT dashboard
- Open
Settings.
- Open
Apps. - Enable
Developer Modeif it is not already enabled.
- Select
Create App. - Enter these values:
- Name:
WoopSocial - Description:
Publish social media content - MCP Server URL:
https://api.woopsocial.com/mcp - Authentication:
OAuth
- Save the app.
- This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
- Return to ChatGPT and start a new chat
- Ask ChatGPT to do something with the MCP. For example tell it to “List my social accounts in woopsocial” or “Create a new post for my Facebook account and schedule it for tomorrow 1pm”
Issues? Just use the chat button in the bottom right and we’ll help you out.
Notion
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- In Notion, click your workspace name in the sidebar and select Settings
- Open Connections, then click Add connection → Custom MCP connection
- Enter
https://api.woopsocial.com/mcpas the MCP server URL - Click Connect, then sign in to WoopSocial and click Authorize
- Ask the chat to “Find my project ID and find my social account IDs with the Woopsocial tools. Then schedule a test post for tomorrow”
- Delete the test post and start creating your own content
Gemini CLI
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- Run:
gemini mcp add woopsocial npx -y mcp-remotehttps://api.woopsocial.com/mcp - Or
edit ~/.gemini/settings.json manuallyand add:
{ "mcpServers": { "woopsocial": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.woopsocial.com/mcp"] } }} - Put the following prompt in Gemini: “Find my project ID and find my social account IDs with the Woopsocial tools. Then schedule a test post for tomorrow”
- Delete the test post and start creating your own content
Cursor
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- Simply go to our official Cursor Directory Page
- Click “Add to Cursor”
- Run through the authorization sequence
- Put the following prompt in Cursor: “Find my project ID and find my social account IDs with the Woopsocial tools. Then schedule a test post for tomorrow”
- Delete the test post and start creating your own content
Get your MCP URL for other AI agents
The clients on this page sign in with OAuth, so they don’t need this. Use it only if your AI agent doesn’t support OAuth yet. The procedure below generates an MCP URL backed by an API key. The URL contains your key, so keep it private.- Open the WoopSocial dashboard API page.
- Click on the “Create API key” button.
- Give the key a name so you can identify it later.
- Copy the MCP URL from the key details page.
The MCP URL uses this format:
- Make sure you have at least one social media account connected (Connect accounts in your dashboard)
- Return to your AI agent
- Ask your AI agent to do something with the MCP. For example tell it to “List my social accounts in woopsocial” or “Create a new post for my Facebook account and schedule it for tomorrow 1pm”
Media upload fix for Claude and ChatGPT
If the client has an allowlist for outbound domains, add*.r2.cloudflarestorage.com so media uploads work. In Claude Code, add it to the sandbox’s allowed network domains in settings.json.