Skwirl

● Active

io.github.Parthuss/skwirl

Search saved Instagram, YouTube and X reels and posts as notes from Claude and ChatGPT.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "skwirl": {
      "url": "https://skwirl.app/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http skwirl https://skwirl.app/mcp
VS Code
code --add-mcp '{"name":"skwirl","type":"http","url":"https://skwirl.app/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
AI & Agents
Version
0.2.1
Registry
active
Published
11/16/2026

Live check

checked Nov 19, 2026, 04:08 UTC
● Working169 msprotocol 2025-06-18v0.2.1tools

The endpoint answered the MCP handshake as "Skwirl" and listed 7 tools. Answering since Nov 18, 2026.

Context cost ≈ 2.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 7 tools.

Tools (7)

tool list changed Nov 19, 2026, 04:08 UTC
  • search_stash3 params

    Search the connected user's Skwirl saves by keyword and meaning before work or planning, or to recover something they saved. Read-only: returns relevance-ordered compact hits with title, summary (up to 140 characters), note ID, date, topic, status and tools, or 'No matching saves.' Use concept words in query; limit is 1–20 (default 5), and optional status is unused or used. Open a relevant ID with get_stash_note; use recent_stash for newest saves or list_stash_mentions for named entities. Usage examples: search_stash({"query":"weeknight pasta","limit":5}); search_stash({"query":"agent memory","status":"unused"}). Returns text (also in structuredContent.text).

    Show parameters
    • querystringrequiredNonempty string of concept words, names or the underlying problem, up to 200 characters. Try a second query if the first is weak. Example: weeknight pasta.
    • statusstringOptional exact status string: unused or used; omit for all saves. Example: unused.
    • limitintegerInteger result count from 1 to 20; defaults to 5. Example: 5.
  • get_stash_note1 param

    Read one Skwirl note by its exact note_id from search_stash, recent_stash or list_stash_mentions. Returns stored Markdown including summary, next step, transcript and source permalink when available; a missing or inaccessible ID returns a no-match message. Each successful call increments the note's open counter, so repeated reads have an additional side effect. Use search_stash to find relevant notes, recent_stash to browse newest saves, or list_stash_mentions to find named entities before opening one. Usage examples: get_stash_note({"note_id":"a1b2c3d4e5f67890"}). Returns text (also in structuredContent.text).

    Show parameters
    • note_idstringrequiredNonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.
  • recent_stash1 param

    List the connected user's newest Skwirl saves, newest creation date first. Recent means the latest limit notes across all time, with no time window: limit is 1–20, default 5. Read-only; returns compact hits with title, summary (up to 140 characters), note ID, date, topic, status and tools, or 'No matching saves.' Use for browsing recent additions; use search_stash for relevance, list_stash_mentions for named entities, and get_stash_note for a full note. Usage examples: recent_stash({"limit":5}); recent_stash({}). Returns text (also in structuredContent.text).

    Show parameters
    • limitintegerInteger result count from 1 to 20; defaults to 5. Example: 5.
  • list_stash_topics

    List topics in the connected user's Skwirl library with note counts, highest count first; ties have no guaranteed order. Read-only and takes no parameters. Returns text lines in topic: count form, or 'No saves yet.' Use to understand the library's subject mix before search_stash; use list_stash_mentions for named books, places or other entities, or recent_stash for newest notes. Usage examples: list_stash_topics({}). Returns text (also in structuredContent.text).

  • list_stash_mentions2 params

    List named entities across the connected user's Skwirl saves, rather than the posts' main topics. Read-only; optionally filter kind and set limit from 1–200 (default 50). Returns text entries with name, type, done flag when present, newest source-note title/ID and repeat count when present. Entities are deduplicated by type/name and ordered by newest source note first; ties have no guaranteed order. Returns an empty-result message if none. Use for saved books, places or people; use search_stash for concepts and get_stash_note for source details. Usage examples: list_stash_mentions({"kind":"book","limit":50}); list_stash_mentions({}). Returns text (also in structuredContent.text).

    Show parameters
    • kindstringOptional entity type string, one of book, movie, show, podcast, place, product, person, other; omit for all types. Example: book.
    • limitintegerInteger result count from 1 to 200; defaults to 50. Example: 50.
  • save_link2 params

    Queue a supported Instagram, Facebook, YouTube or X link in Skwirl. Requires an authenticated Skwirl connection and the user's intent to save the link; do not use just to read it. Writes a capture for asynchronous processing; success says the note should be ready in a few minutes, not that it is ready now. An existing normalized link in this account returns 'Already saved.' without replacing its reminder. Unsupported links, permission/plan restrictions or queue limits return explanatory failure text. Use search_stash or recent_stash to find a processed note later. Usage examples: save_link({"url":"https://www.instagram.com/reel/ABC123/","note":"Try this recipe"}). Returns text (also in structuredContent.text).

    Show parameters
    • urlstringrequiredHTTPS URL string for a supported Instagram, Facebook, YouTube or X post. Example: https://www.instagram.com/reel/ABC123/.
    • notestringOptional free-text string, up to 500 characters, explaining why the user wants to save this link; omit if not supplied. Example: Try this recipe.
  • mark_stash_used1 param

    Record that a Skwirl note shaped the user's work, decision or action; call after applying it, rather than merely reading it. Uses an exact note_id from search_stash, recent_stash or list_stash_mentions. Sets status to used and replaces used_at with the current timestamp; tracks use and changes status-filter results, with no search-ranking boost. Repeating keeps status used but refreshes the timestamp, so it is not fully idempotent. Returns 'Marked as used.' or a no-match message for a missing or inaccessible ID; note content is retained. Usage examples: mark_stash_used({"note_id":"a1b2c3d4e5f67890"}). Returns text (also in structuredContent.text).

    Show parameters
    • note_idstringrequiredNonempty string ID returned by search_stash, recent_stash or list_stash_mentions; use it verbatim. Example: a1b2c3d4e5f67890.

Checked by Serverdex with a plain initialize + tools/list call to skwirl.app/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 16, 2026
Stars
2
Forks
0
Last push
Nov 13, 2026
License
Other

Python

From the README

Skwirl Turn the reels you save into notes Claude finds on its own. Live at https://skwirl.parthakholkar.com. (The product was called Stash until 2026-10-29. The code, the Python package and the MCP tool names still say stash; only the brand changed.) Built by Parth Akholkar. The case study explains why it works this way. You already capture reliably — share, tap your own account, done. What fails is everything after: a URL tells you nothing about what was in the post, so you never triage it, and nothing surfaces it when it would be useful. This is not a bookmarking tool. It transcribes what you saved and hands it back unprompted while you work. https://github.com/user-attachments/assets/14edb1e5-5f7a-46ea-96dd-a7c2c51c223e Try it (5 minutes) The whole pipeline, no phone and no Cloudflare required yet — just a free Groq key (Groq Whisper transcribes reel/video audio; qwen/qwen3.6-27b reads posts, carousels, and reel frames into the final JSON note; no Claude call happens while processing). Skipped the key prompt? Add GROQAPIKEY=... to .env and re-run .venv/bin/python -m stash doctor — it names anything still missing and the exact command to fix it.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://skwirl.app/mcp

Alternatives to Skwirl

Best AI & Agents servers →

The most-starred AI & Agents servers in the index, with their live-check result.

ServerStarsLast pushLive check
Ruflo81,994Nov 2026Local / not checked
Claude Flow81,985Nov 2026Local / not checked
CodeBurn11,805Nov 2026Local / not checked
Kaneo9,825Nov 2026Local / not checked
Ha MCP7,958Nov 2026Local / not checked

Skwirl: questions people ask

Is Skwirl a remote or a local MCP server?
According to its entry in the official MCP registry, Skwirl ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Skwirl need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
Is Skwirl still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 13, 2026, 2 GitHub stars, Other licence. Read from GitHub on Nov 16, 2026.
What tools does Skwirl expose?
7 tools as listed by the server itself during the live check, including search_stash, get_stash_note, recent_stash, list_stash_topics, list_stash_mentions. The full list with parameters is in the Live check section above.
How do I add Skwirl to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all AI & Agents →

Add the badge to your site

Show visitors that Skwirl is listed here — it’s also the link we check for a free listing.

Skwirl — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-parthuss-skwirl?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Skwirl — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Skwirl — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-parthuss-skwirl?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.