← Skwirl

How do I connect Skwirl to Claude Code without the plugin?

By Parth Akholkar, who makes Skwirl · 18 November 2026

When would you connect Claude Code without the plugin?

Use the direct connection when you want a tool Claude Code can call during a session. For example, you can ask for that reel about naming design tokens while you are preparing a migration, then have Claude Code open the note and cite the original. There is no automatic Skwirl hook in these steps. The separate Skwirl plugin setup installs a hook that checks prompts for relevant saves and uses a personal plugin key.

Have Claude Code installed and signed in, and keep at least one finished note in your Skwirl library. To make a test note, copy the link to a public reel, paste it into Skwirl and wait for its reading card to become a note. Keep the title handy so you know what a successful search should find.

How do you add Skwirl and sign in with OAuth?

  1. Register the server in your shell. Use the remote HTTP transport and user scope if you want the connection in your projects on this machine.
    claude mcp add --transport http skwirl --scope user https://skwirl.app/mcp
  2. Start a Claude Code session. Run claude, enter /mcp, select skwirl and follow the authentication prompt. Current versions also document claude mcp login skwirl from your shell.
  3. Authorize Skwirl in your browser. Sign in to the account with your saved notes and choose Allow on the consent page. Return to Claude Code when the browser flow finishes.
  4. Run a known-note search. Ask Claude Code to use Skwirl to find the test reel by title, open the matching note and return its original link. Compare the link with the one you saved.

Anthropic documents the HTTP transport, configuration scopes and OAuth flow. Skwirl’s implementation confirms the OAuth endpoint and note tools. This exact plugin-free sign-in has not been tested end to end for this guide. Anthropic’s Claude Code MCP documentation.

How do you tell whether a result came from your library?

Use Skwirl to find the note I saved about naming design tokens across themes. Open the strongest match and give me the note title, the original link and one suggestion from the note. If none of my saves are about that, say so.

Skwirl’s search returns short matches. Asking Claude Code to open the strongest note gives it the fuller extract. Ask for the title and link so you can distinguish a retrieved note from a general response. For a weak match, retry with the design tool, the creator or a phrase from the video. If the note contains settings you intend to apply, check them against the source before changing files.

What should you check if the connector is missing?

Run claude mcp list in your shell. If Skwirl is missing, check the registration scope and the directory where you added it. Claude Code’s default scope is local to the current project. A managed workspace can restrict remote MCP servers, so ask whoever manages it if the client reports a policy restriction. If the server appears but asks for authentication, reopen /mcp and finish browser consent.

If you are finished with the direct connection, use claude mcp remove skwirl from your shell to remove the registration. For the separate plugin, use the turn-off controls described in the plugin guide.

What else should you know about the direct connection?

Does direct OAuth install the Skwirl recall hook?

No. It registers the MCP tools. The separate Skwirl plugin includes the prompt hook, so explicitly ask Claude Code to search Skwirl when you want a saved note.

Can Claude Code search everything I bookmarked inside Instagram?

It searches the notes in your Skwirl account. Share or paste a public link, or import an Instagram Saved export, to give Skwirl material to process.

Will Claude Code get write tools too?

Yes. Skwirl’s MCP server includes tools to save a link and mark a note as used. Ask for a read-only lookup if you only want to find and read notes.

Try Skwirl free