echoia®
Echoia

Connect Claude to your social media accounts

Once Echoia is connected, Claude can read the comments and messages from Instagram, TikTok, Facebook, LinkedIn and six other platforms, draft and schedule posts, and tell you what worked. This guide covers claude.ai and the desktop app first, then Claude Code.

Works today
Works onEvery Claude plan, Free included
Connects withKey in a header (or in the address)
Setup timeAbout 2 minutes

Works today on every Claude plan, the free one included.

What you can ask Claude

“Anything I should answer today?
“Draft Tuesday's restock post for Instagram and Threads and schedule it for 6pm.
“Compare my Instagram and TikTok engagement this month.

Claude gets six tools from Echoia (accounts, posts, stats, creating a post, reading comments, replying) across Instagram, Facebook, TikTok, YouTube, X, LinkedIn, Threads, Bluesky, Pinterest and Google Business, limited to what your key allows.

Before you start

An Echoia account. The free plan is enough.
A Claude account. The Free plan allows one custom connector, so Echoia would use your only slot. Pro and Max do not have that limit.
On a Team or Enterprise plan, an owner adds the connector once for the whole organization, under Organization settings, then Connectors. Members then connect to it from their own Connectors page.

STEP 1 OF 2

Create your Echoia key

Claude connects with a key you create and can revoke at any time. It takes a minute.

  1. 1
    Open the Developers settings

    Sign in to Echoia, open Settings, then Developers.

  2. 2
    Create a key and choose what it may do

    Name it after the assistant so you recognise it later, and tick its permissions (explained further down). If you have several workspaces, choose which ones it can reach.

  3. 3
    Copy the key now

    It starts with eko_ and is shown only once: Echoia keeps only a fingerprint of it. If you lose it, revoke it and create a new one.

STEP 2 OF 2

Connect Claude

Pick the one you use. You can do both with the same key.

OPTION A
claude.ai and Claude Desktop
For everyday use in the chat, on the web or in the desktop app.
OPTION B
Claude Code
For the terminal. Claude Code can also upload images and videos from your disk, which the chat cannot do.
OPTION A

claude.ai and Claude Desktop

  1. 1
    Open the connector settings

    In claude.ai or in the desktop app, go to Customize, then Connectors. Click + Add, then Add custom connector.

  2. 2
    Enter the Echoia server

    Name the connector Echoia, paste this address in the server URL field, and click Continue.

    Server URL
    https://mcp.echoia.io/mcp
  3. 3
    Send your key as a header

    When Claude asks how to authenticate, choose No sign in. Under Request headers, add one header named Authorization whose value is the word Bearer, a space, and your key. Then click Add.

    Request header
    Authorization: Bearer eko_your_key
  4. 4
    If your screen has no header field

    Some accounts still show the older form, with a URL field only. In that case, paste the address that contains your key instead. Echoia shows it under Settings, Developers, in the Remote tab. That address works like a password, so keep it to yourself.

    Server URL with your key
    https://mcp.echoia.io/mcp/eko_your_key
  5. 5
    Switch it on in a conversation

    In a chat, click the + button at the bottom left, open Connectors, and turn Echoia on. Then ask your first question: "Anything I should answer today?" works well.

OPTION B

Claude Code

  1. 1
    Add the server

    Put your key in the ECHOIA_API_KEY environment variable, then run this command once. The key stays in a header and never appears in an address.

    Terminal
    claude mcp add --transport http echoia https://mcp.echoia.io/mcp \
  --header "Authorization: Bearer $ECHOIA_API_KEY"
  2. 2
    Check the connection

    Run claude mcp list: Echoia should appear as connected. Inside a session, the /mcp command shows the same list with each server's tools.

    Terminal
    claude mcp list
  3. 3
    Install the skill (optional)

    The Echoia skill tells Claude Code when to act and how to upload a file from your disk before attaching it to a post. It contains no secret: it reads your key from ECHOIA_API_KEY.

    Terminal
    mkdir -p ~/.claude/skills/echoia && curl -s https://app.echoia.io/api/v1/skill > ~/.claude/skills/echoia/SKILL.md

Which permissions to give Claude

Read

Accounts, posts, stats and comments. Looks at everything, changes nothing.

Write

Drafts, scheduled posts and media uploads. A scheduled post goes out at its time.

Engage

Replies to comments in public, as your account.

Publish

Posts immediately, with no window to change your mind.

Our advice for Claude: Start with Read only for the first week and watch how Claude summarises your inbox. Add Write when you want it to fill your calendar, and keep Publish and Engage for when you trust its judgement.

Limits worth knowing

An image you paste into the chat cannot be attached to a post. Claude sees the picture but cannot hand the file over to another service. Give it a public image link, or use Claude Code, which uploads the file from your disk.
With the Free plan's single custom connector, adding Echoia means you cannot add another custom connector at the same time.
Claude asks for your approval before it uses a tool, unless you allow that tool for the rest of the conversation. Keep the approval on for replies and publishing.

Questions

Does it work in the Claude mobile app?

Yes. Add the connector from the web or the desktop app; Claude's connections run from Anthropic's servers, so the connector is then available in the mobile apps as well.

Can Claude publish without asking me?

Only if your key has the Publish scope. With Write alone, Claude can create drafts and schedule posts. A scheduled post does go out at its time, so check your calendar, where you can edit or cancel anything before then.

Where does my key live, and how do I cut access?

In the connector's settings at Anthropic, which sends it with each request. To cut access, revoke the key in Echoia under Settings, Developers. It stops working on the next request, whatever Claude is doing.

Ready to try it with Claude?

Create a free Echoia account, connect your social accounts, and your key is one click away. No card needed.