Integrations
Connect OmniSocials with your favorite tools and AI assistants. All integrations use your API key for authentication.
Claude
Setup via claude.ai
- Create an API key in OmniSocials (Settings > API)
- Copy the MCP URL shown next to your key
- Go to Claude Settings > Integrations
- Click "Add custom connector", paste the MCP URL, and save
Setup via Claude Code
Code
Then set your API key:
Code
Setup via Claude Desktop
Add to your claude_desktop_config.json:
Code
ChatGPT
Setup
- Create an API key in OmniSocials (Settings > API)
- Copy the MCP URL shown next to your key
- Go to ChatGPT Settings > Connectors > Advanced
- Click "Create", paste the MCP URL, set authentication to "No auth", and save
Verify
Open a new chat and ask ChatGPT to list your OmniSocials accounts. A successful response confirms the connection.
Notion
Setup
- Create an API key in OmniSocials (Settings > API)
- In Notion, go to Settings > Connections > MCP Tools
- Click "Add tool" and enter:
Code
- Choose "Bearer Token" as the authentication method and paste your API key
Verify
Ask a Notion Agent to list your OmniSocials accounts. If it returns your connected profiles, you're good to go.
MCP Server
OmniSocials provides an MCP server that works with any compatible client. See the dedicated MCP Server page for detailed setup instructions.
Supported Clients
| Client | Transport |
|---|---|
| Claude (claude.ai) | Remote MCP URL |
| ChatGPT | Remote MCP URL |
| Claude Code | npm package |
| Claude Desktop | npm package |
| Cursor | npm package |
| Windsurf | npm package |
| Notion | Remote MCP URL + Bearer Token |
Agent Skills
Agent Skills work with any AI coding tool that can read markdown and run commands -- not just MCP-compatible ones. This includes Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, Gemini CLI, and many more.
Install
Code
Setup
After installing, run the setup command to configure your API key:
Code
Or set the environment variable:
Code
What you can ask your agent
Once installed, you can ask your AI agent things like:
- "Show my connected social accounts"
- "Create a LinkedIn post announcing our new feature"
- "Schedule an Instagram reel for tomorrow at 9am"
- "How are my posts performing this week?"
- "Upload this image and create a Pinterest pin"
How it works
Unlike the MCP server (which uses a structured protocol), Agent Skills work by providing a SKILL.md instruction file that teaches AI agents how to use a CLI tool. The CLI wraps the OmniSocials API with 22 commands covering posts, media, accounts, analytics, and webhooks.
This approach is compatible with more tools since it only requires markdown reading and bash execution -- capabilities that virtually all AI coding agents support.
Agent Skills vs MCP Server
| Agent Skills | MCP Server | |
|---|---|---|
| Works with | All AI coding tools | MCP-compatible tools only |
| Install | npx skills add | npx -y @omnisocials/mcp-server |
| Protocol | CLI commands via bash | MCP structured tools |
| Best for | Broad compatibility | Deep integration |
Both use the same API and API key. You can use both simultaneously.
See the omnisocials-agent-skills repo for full documentation.