Using sfeed with Claude Code

Claude Code can use sfeed through normal shell commands or through MCP. The main thing to keep explicit is page choice when more than one Page is connected.

If you want Claude Code to handle setup step by step in the terminal, use the agent setup prompt.

1. Install and authenticate

curl -fsSL https://sfeed.dev/install.sh | sh
sfeed auth facebook

This is enough for Claude Code to use sfeed from the terminal. Ask for a dry run first when you are testing.

2. Optional: add MCP tools

claude mcp add sfeed -- sfeed mcp
claude mcp list

Claude Code also supports user, project, and local MCP scopes. Use the default local scope for a personal setup in one project. Use --scope user if you want sfeed available across projects.

Config form

{
  "mcpServers": {
    "sfeed": {
      "type": "stdio",
      "command": "sfeed",
      "args": ["mcp"]
    }
  }
}

First prompt to try

Use sfeed to check my status. If MCP tools are available, call sfeed_status. Otherwise run sfeed status. If more than one Page is connected, list the Pages and ask which one to use.

Claude Cowork

Claude Cowork runs in Claude Desktop and can work with local files and local plugin MCP servers. For sfeed, use the same local requirements: install sfeed, run sfeed auth facebook, and add a local MCP server that launches sfeed mcp. If your organization manages Cowork plugins or MCP access, the admin policy must allow local MCP servers or provide sfeed through a managed plugin.

For plain terminal use, use Claude Code. Cowork is better when the work starts from local folders, documents, or a desktop workflow and the app has access to the folders that contain your posts and media.

CLI-only prompts

Run sfeed status and tell me which Pages are connected.

Run this dry run without publishing: sfeed post "Test post from sfeed CLI" --to facebook --dry-run

Post ./assets/launch-card.jpg to Instagram after showing me the caption and asking for approval.

MCP prompts

Call sfeed_status and summarize the account state.

Call sfeed_pages if more than one Page is connected.

Use sfeed_post to schedule a Facebook post for tomorrow at 9am Eastern. Ask me to confirm before scheduling.

Demo script you can record

1. Start Claude Code with sfeed configured
2. Ask it to inspect sfeed status
3. Ask it to post a local image to Instagram
4. Confirm the drafted caption
5. Show the final result URL or media ID

FAQ

Can Claude Code use sfeed without MCP?

Yes. Claude Code can run the sfeed CLI directly through its shell tool.

When should I add MCP?

Add MCP when you want Claude to call structured tools like sfeed_status, sfeed_pages, and sfeed_post. That usually gives better agent behavior than asking it to remember command syntax.

Does Claude Cowork need a different sfeed account?

No. Cowork still uses the local sfeed install and the local Meta auth state created by sfeed auth facebook.

Open the Cookbook

Back to Docs