How do I use my saved Instagram Reels in Gemini CLI?
By Parth Akholkar, who makes Skwirl · 18 November 2026
What do you need before running the commands?
Have Gemini CLI installed and ready to start an interactive session. Use a computer with a local browser for the OAuth step. Signing in to Gemini CLI gets the assistant running. When the Skwirl connection asks for authorization, use the separate Skwirl account that contains your notes.
Prepare an easy test. Copy the link to one public Reel, paste it into the save box in Skwirl and wait for the processed note to appear. If you saved a tip about making book photos easier to catalog, open its note and copy a distinctive phrase from the summary. Use that phrase to test the connection before searching more loosely.
How do you add and authorize Skwirl in Gemini CLI?
- Add the remote server from your regular shell. The HTTP transport flag selects Streamable HTTP. The user scope makes this configuration available across projects for your user account. Omit the scope flag if you deliberately want Gemini CLI's default project scope.
gemini mcp add --scope user --transport http skwirl https://skwirl.app/mcp
- Start an interactive Gemini session. If the server needs authentication, run
/mcp auth skwirlinside that session. Follow the browser prompt, sign in to Skwirl and choose Allow.gemini
- Type
/mcp listinside Gemini to check the server and its tools. Ask Gemini to search Skwirl for the distinctive phrase from your test note. Review any tool confirmation and check the original link in the response against your Skwirl library.
Skwirl checked the commands and OAuth behavior against the official Gemini CLI documentation. The complete Skwirl sign-in and retrieval flow in Gemini CLI has not been tested end to end for this guide. Gemini CLI's MCP server documentation
How do you use a saved Reel in a terminal project?
Search Skwirl for Reels I saved about cataloging a home library from book photos. Open the most relevant note. Give me its title and original URL, then draft a five-column CSV header based on the fields the source actually mentions. Keep any extra field suggestions separate.
Gemini can search Skwirl notes using an exact word or a description of the idea. Asking it to open a match gives it the full note, which may include a transcript and summary. In the catalog example, the Reel might discuss ISBNs and author names while saying nothing about condition or lending. Separating suggestions from source details lets you decide whether those extra fields are worth collecting.
Start with a draft in the reply. If it looks useful and you later want Gemini to create a file, give it a location in the workspace. You can also copy a short note directly into the session if you already know which one to use.
What if OAuth opens a browser but never finishes?
Gemini CLI's documented OAuth flow needs a browser that can return to the CLI's local callback. If Gemini is running over SSH or inside a headless container and the browser cannot reach that callback, try the setup in a local interactive session. Complete authentication there and use that session to verify retrieval. Avoid copying credentials from one machine into a project configuration file.
If the original add command worked but the session still cannot see the server, check /mcp list and whether you used the intended scope. A project-scoped entry may be missing when you start the CLI from another directory. If the tool ran and found no results, look for the test note in Skwirl and retry with its exact title.
What else should you know about Skwirl in Gemini CLI?
Does Gemini CLI import my Instagram bookmarks?
Gemini CLI queries the Skwirl library you connect. Add Reel links to that library from Skwirl before asking Gemini to retrieve their notes.
Do I need to paste a Skwirl API key into Gemini CLI?
The remote setup uses browser-based OAuth. The server address identifies Skwirl, and your browser sign-in grants the connection access to your library.
How do I remove this server from my user configuration?
Run gemini mcp remove --scope user skwirl from the shell. If you added it with project scope, run the removal command in that project with project scope instead.