Caelario

io.github.chunkydonut21Published by GitHub account chunkydonut21v0.1.5Updated Oct 24, 2026

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

Overview

AI-generated overview

Caelario is a local MCP server that gives assistants typed tools to extract and automate social media data from Instagram, TikTok, YouTube, X and Facebook.

What you can do
Run immediate and durable extractions of profiles, posts and other social media data across five platforms, with result pagination and credit estimates for each job. Search and discover content and accounts, and manage batches and schedules for recurring collection. Access saved results and usage workflows through the Caelario workspace. Discover available capabilities before running a job.
When to use it
Use it when you want an assistant to pull public social media data or set up recurring extraction jobs across Instagram, TikTok, YouTube, X or Facebook without handling each platform's own credentials.
Requirements
Runs locally over stdio via the npm package caelario-mcp; Node.js 20 or newer is required. A Caelario workspace API key is needed, supplied as the CAELARIO_API_KEY environment variable; the installer prompts for it and registers the server at user scope. A Caelario account and network access to the hosted API are implied.
Before you install
The server uses a revocable Caelario workspace API key (CAELARIO_API_KEY), which should be kept private. Extraction, batches and schedules consume Caelario credits, so usage may incur billing; check the provider's billing details. Jobs send requests to Caelario's hosted proprietary API, and provider identities are managed by Caelario rather than by you. Schedules and batches create recurring work that may keep spending credits.

Installation

In SourceWeft

  1. Open Caelario in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npx -y caelario-mcp install codex

Install for Claude Code

bash
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.

Source: README.md at commit b3d6a14

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts