About Caelario
Caelario is a social data MCP server for Codex and Claude Code, covering Instagram, TikTok, YouTube, X, and Facebook with extraction, search, batch, and scheduling workflows.
Key features
- 01Multi-platform data extraction
- 02Search and discovery
- 03Batch and scheduled runs
- 04Result pagination and saving
- 05Capability and credit estimates
Use cases
- 01Fetch an Instagram profile and recent posts
- 02Search content across social platforms
- 03Schedule recurring data extraction
MCP support
Its local stdio MCP server provides typed tools for Codex and Claude Code, including capability discovery, extraction, and result pagination.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y caelario-mcpCAELARIO_API_KEYSecretA revocable Caelario workspace API key from the Developers page.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
21Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project READMECaelario 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.
Install for Codex
npx -y caelario-mcp install codex
Install for Claude Code
npx -y caelario-mcp install claude
The installer 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.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.