FavStash for agents

Bring your stash into the conversation

Use a remote MCP connection to search inspiration, plan posts, and check your social accounts. Sign in with FavStash and approve access in your browser.

Using Codex or Claude Code with local files? Start with the CLI guide. This page is a guide; the server URLs below are the endpoints your agent connects to. Read as Markdown.

Choose your agent

Connect Claude

Listed in Claude’s connector directory for Claude web, Desktop, Cowork, and mobile. Workspace policy may require an administrator to allow it.

Open FavStash in Claude’s directory

In Claude, open Customize → Connectors → Discover and search for “favstash”, or open the FavStash listing directly.
Select FavStash, then Connect. Sign in to FavStash in your browser and approve the requested access.
Enable FavStash in the conversation and run the verification prompt below.

Verify the connection

prompt

Use FavStash's get_stash_summary tool once with no filters. Report whether it succeeded and the returned counts. Zero counts are valid. Do not modify any data.

A successful response can include zero counts. Browser approval, configuration, or tool discovery alone does not verify access to your account.

OAuth is the default. For unattended jobs or hosts without OAuth, create a scoped API key in AI Connect and store it as FAVSTASH_API_KEY in your local secret environment. Never paste tokens into a chat or commit them.

Use favstash auth status to inspect local sign-in, favstash doctor to check remote compatibility, and favstash auth logout to revoke the CLI session. An API key in the environment takes precedence over OAuth.

If sign-in is approved but the agent reports an initialization or protocol error, save the error and your client version for support. Repeating sign-in may not fix a server compatibility issue. Verify a read after reconnecting before calling the setup complete.

OAuth credentials use the OS credential store. On a private machine without a usable keychain, explicitly choose favstash auth login --credential-store file. For SSH, containers, and cloud tasks, the browser must be able to reach the CLI’s loopback callback; otherwise use the host’s remote OAuth support or a securely supplied API key.

Update with npm install -g @sketric/favstash-mcp@latest, then restart the agent. A remote MCP connection cannot read arbitrary paths on your computer.

Agent installation guide CLI reference API reference

Choose your agent

Connect Claude

Add a custom connector instead

Verify the connection

API keys and troubleshooting