Skip to main content
Use this page to connect the WoopSocial MCP server to your AI agent, Claude, ChatGPT or your CLI.

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.
  1. 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.
  2. Read the notice Claude shows for Community connectors, then continue
  3. Sign in to WoopSocial, or create a free account, and click Authorize
  4. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  5. Start a new Chat in Claude. If WoopSocial isn’t turned on, click + → Connectors and toggle it on
  6. Ask Claude to write a test post to your social account for tomorrow
  7. It will find your Project ID and Social Account ID and will schedule a test post for tomorrow
  8. If you want, you can delete the post straight away
The connector belongs to your Claude account, so you only add it once. Can’t use the directory? Add WoopSocial as a custom connector instead. Go to Customize → Connectors → + Add → Add custom connector, name it 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.
  1. Ensure that you have a WoopSocial account and you are logged in
  2. Connect a social media account through your WoopSocial dashboard
  3. Start claude
  4. In Claude, type /mcp
  5. Select the woopsocial · △ needs authentication menu item
  6. Select Authenticate
  7. This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
  8. Return to Claude
  9. 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”
Issues? Just use the chat button in the bottom right and we’ll help you out.

Codex CLI

  1. Ensure that you have a WoopSocial account and you are logged in
  2. Connect a social media account through your WoopSocial dashboard
  3. Use the codex mcp add command to register WoopSocial with Codex.
  1. This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
  2. 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”
Issues? Just use the chat button in the bottom right and we’ll help you out.

ChatGPT

  1. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  2. Now go to your ChatGPT dashboard
  3. Open Settings.
Open ChatGPT settings
  1. Open Apps.
  2. Enable Developer Mode if it is not already enabled.
Enable Developer Mode in ChatGPT
  1. Select Create App.
  2. Enter these values:
  • Name: WoopSocial
  • Description: Publish social media content
  • MCP Server URL: https://api.woopsocial.com/mcp
  • Authentication: OAuth
  1. Save the app.
  2. This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
  3. Return to ChatGPT and start a new chat
  4. 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”
Test the ChatGPT app by listing social accounts Issues? Just use the chat button in the bottom right and we’ll help you out.

Notion

  1. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  2. In Notion, click your workspace name in the sidebar and select Settings
  3. Open Connections, then click Add connection → Custom MCP connection
  4. Enter https://api.woopsocial.com/mcp as the MCP server URL
  5. Click Connect, then sign in to WoopSocial and click Authorize
  6. 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”
  7. Delete the test post and start creating your own content
Issues? Just use the chat button in the bottom right and we’ll help you out.

Gemini CLI

  1. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  2. Run:
    gemini mcp add woopsocial npx -y mcp-remote https://api.woopsocial.com/mcp
  3. Or edit ~/.gemini/settings.json manually and add:
    {  "mcpServers": {    "woopsocial": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.woopsocial.com/mcp"]    }  }}
  4. 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”
  5. Delete the test post and start creating your own content
Issues? Just use the chat button in the bottom right and we’ll help you out.

Cursor

  1. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  2. Simply go to our official Cursor Directory Page
  3. Click “Add to Cursor”
  4. Run through the authorization sequence
  5. 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”
  6. Delete the test post and start creating your own content
Issues? Just use the chat button in the bottom right and we’ll help you out.

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.
  1. Open the WoopSocial dashboard API page.
  2. Click on the “Create API key” button.
  3. Give the key a name so you can identify it later.
Name the API key
  1. Copy the MCP URL from the key details page.
Copy the MCP URL from the API key details page The MCP URL uses this format:
  1. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
  2. Return to your AI agent
  3. 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”
Issues? Just use the chat button in the bottom right and we’ll help you out.

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.