​

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 Chat / Cowork
• Claude Code
• Codex
• All AI Agents
• ChatGPT
• Notion
• Gemini CLI
• Cursor

​

Claude Chat / Cowork

1. Grab your MCP link from your API Key Page
2. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
3. Then go to your Claude app
4. Go to Settings in Claude → Connectors → Customize
5. Click Add Connector → Add Custom Connector
6. Name it ‘woopsocial’ and use https://api.woopsocial.com/mcp as the URL
7. Click Add and Authorize on the next page
8. Start a new Chat in Claude → Ask it to write a test post to your social account for tomorrow
9. It will find your Project ID and Social Account ID and will schedule a test post for tomorrow
10. If you want, you can delete the post straight away

​

Claude Code CLI

claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

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”

​

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.

codex mcp add woopsocial --url https://api.woopsocial.com/mcp
codex mcp login woopsocial

4. This should take you to WoopSocial where you can Authorize the MCP connection. Click the “Authorize” button.
5. 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”

​

Get your MCP URL for other AI agents

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.

4. Copy the MCP URL from the key details page.

https://api.woopsocial.com/mcp?api_key=YOUR_API_KEY

5. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
6. Return to your AI agent
7. 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”

​

ChatGPT

1. Grab your MCP link from your API Key Page
2. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
3. Now go to your ChatGPT dashboard
4. Open Settings.

5. Open Apps.
6. Enable Developer Mode if it is not already enabled.

7. Select Create App.
8. Enter these values:

• Name: WoopSocial
• Description: Publish social media content
• MCP Server URL: paste the MCP URL you copied earlier
• Authentication: No Auth

9. Save the app.
10. Return to ChatGPT and start a new chat
11. 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”

​

Notion

1. Grab your MCP link from your API Key Page
2. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
3. Now go to your Notion dashboard
4. Go to Settings → Connections → + Add Custom MCP
5. Enter your unique MCP Server URL (from step 1) and name it “woopSocial”
6. Click Connect and complete the OAuth flow
7. 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”
8. Delete the test post and start creating your own content

​

Gemini CLI

1. Grab your MCP link from your API Key Page
2. Make sure you have at least one social media account connected (Connect accounts in your dashboard)
3. Run:
   gemini mcp add woopsocial npx -y mcp-remote https://api.woopsocial.com/mcp
4. Or edit ~/.gemini/settings.json manually and add:
   {  "mcpServers": {    "woopsocial": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.woopsocial.com/mcp"]    }  }}
5. 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”
6. Delete the test post and start creating your own content

​

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

​

Media upload fix for Claude and ChatGPT