English Français العربية

Caelario

Official registry Marketing and sales

MCP server for Instagram, TikTok, YouTube, X and Facebook data extraction and automation.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package caelario-mcp
Claude Code 
claude mcp add caelario -e 'CAELARIO_API_KEY=<your caelario_api_key>' -- npx -y caelario-mcp@0.1.5
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "caelario": {
            "command": "npx",
            "args": [
                "-y",
                "caelario-mcp@0.1.5"
            ],
            "env": {
                "CAELARIO_API_KEY": "<your caelario_api_key>"
            }
        }
    }
}

Environment variables

  • CAELARIO_API_KEY required secret A revocable Caelario workspace API key from the Developers page.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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.

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.

Frequently asked questions

What is Caelario?

MCP server for Instagram, TikTok, YouTube, X and Facebook data extraction and automation.

How do I install Caelario?

It runs on your machine. In Claude Code: claude mcp add caelario -e 'CAELARIO_API_KEY=<your caelario_api_key>' -- npx -y caelario-mcp@0.1.5. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Caelario need an API key?

Yes. It expects CAELARIO_API_KEY, which you set in its configuration.

Is Caelario open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Caelario?

It is published by chunkydonut21. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.