Caelario MCP
MCP server for social media data from Instagram, TikTok, YouTube, X and Facebook. Run extractions, search and discovery, batches, schedules, saved results and usage workflows through Caelario.
Source: https://github.com/chunkydonut21/caelario-mcp
The official local server gives Codex and Claude Code typed tools for capability discovery, immediate and durable extraction, result pagination, and credit estimates.
New to Caelario?
Open the guided setup. Create a free account with Google or email, choose Codex or Claude Code, and create a connection key. The page shows each step and helps you check the connection. New accounts start with 200 free credits.
The installer opens this setup page automatically when you do not already have a key, or when the key in your terminal environment is rejected. It lets you replace a rejected or incomplete key without restarting the command. Paste the key only into its secure terminal prompt, never into AI chat.
Install for Codex
npx -y caelario-mcp@latest install codex
Install for Claude Code (terminal or desktop)
npx -y caelario-mcp@latest install claude
The installer uses the terminal CLI when available. If it is missing, it detects Claude desktop and configures its local MCP settings directly, including support for local Code tab sessions. You do not need to install a separate CLI.
To choose Claude desktop explicitly (also for its regular chat surface), run:
npx -y caelario-mcp@latest install claude-desktop
Quit Claude completely and reopen it after installation. Approve Caelario when Claude asks, then ask it to check your connection and available credits. Existing desktop settings and other MCP servers are preserved. If the settings file is malformed, the installer stops without overwriting it.
The installer finds your assistant before starting setup. On Windows it also
finds the Codex desktop app when codex is absent from your terminal PATH. It
prompts for a Caelario workspace API key and registers the stdio server at user
scope. It does not ask for Instagram, TikTok, YouTube, X, or
Facebook credentials; provider identities are managed by Caelario.
After installation, restart the client and ask:
Use Caelario to get Nike's Instagram profile and 10 recent posts.
The package requires Node.js 20 or newer. See https://caelario.com/mcp-server for security, billing, and tool details.
If a request times out, reuse the idempotency_key returned in the tool error
with identical arguments. This recovers the original request instead of starting
another paid extraction. The default HTTP timeout is 120 seconds; failed job
results include their error and remain marked as not ready.
The connector is released under the MIT License. Caelario's hosted API, provider implementations, acquisition infrastructure, and managed identities are separate proprietary services and are not included in this package.
The npm artifact also includes official MCP Registry metadata under
io.github.chunkydonut21/caelario. npm publication must happen before the
separate Registry publication step.