Name: Caelario
Author: chunkydonut21

What can you do with Caelario?

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.

Install

Add Caelario to your client. Pick the one you use.

claude mcp add caelario-mcp -- npx -y caelario-mcp

codex mcp add caelario-mcp -- npx -y caelario-mcp

amp mcp add caelario-mcp -- npx -y caelario-mcp

{
  "mcpServers": {
    "caelario-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "caelario-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"caelario-mcp","command":"npx","args":["-y","caelario-mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "caelario-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "caelario-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "caelario-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "caelario-mcp": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "caelario-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "caelario-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y caelario-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation14/25
Maintenance25/25
Trust6/20
Capability0/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 6 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.1.5Latest	Aug 25, 2026
0.1.4	Aug 25, 2026
0.1.2	Aug 25, 2026