otherapi_key

Supermemory

Supermemory is a memory and context API for ingesting, organizing, searching, and recalling information across applications.

Verdict

Supermemory turns every document, URL, and snippet your team saves into searchable context the AI can recall on demand. When you @mention Supermemory in a Project, the AI can ingest new content, retrieve past documents by topic or metadata, pull learned profiles from your knowledge base, and surface relevant chunks without you hunting through folders. Marketing teams use it to keep campaign briefs accessible; support teams index help articles and past tickets; product managers store spec docs and user research. The catch: you manage documents by container tags and IDs, so a little upfront tagging discipline pays off when the workspace grows past a few dozen entries.

Common use cases

  • Index competitor blog posts for research
  • Store customer feedback transcripts by quarter
  • Retrieve onboarding docs during new-hire chat
  • Tag and search past sprint retrospectives
  • Build a searchable library of design specs

Integration

Vendor
Supermemory
Category
other
Auth
API_KEY
Tools
11
Composio slug
supermemory

Tools

  • Add Document

    Ingest text or a public URL as a Supermemory document and return its document ID and initial processing status.

  • Add Documents

    Add 1 to 600 documents in one request, with explicit per-document metadata and processing options. HTTP 200 may contain partial failures; callers must inspect failed, success, and every result rather than treating 200 as complete batch succ

  • Delete Document
    destructive

    Permanently delete one document by ID. This does not remove the document's container-tag settings record.

  • Get Account Status

    Return the connected Supermemory organization's plan, credit balance, high-level usage, and reset date.

  • Get Document

    Get one document's content, metadata, source details, and processing status by document ID.

  • Get Document Chunks

    Return the ordered extracted chunks for one processed document.

  • Get Profile

    Retrieve the static, dynamic, or bucketed profile learned for one container tag, optionally with matching search results.

  • List Documents

    List documents, optionally filtered by containers, metadata, or filepath, one page at a time.

  • List Memories

    List extracted memory entries for one or more container tags, one page at a time.

  • Search Memory

    Semantically search Supermemory memories, document chunks, or both, with optional container and metadata filters.

  • Update Document

    Update the content, metadata, container, or processing configuration of one existing document. When metadata is supplied, it completely replaces the document's metadata, so omitted metadata keys are removed.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration,' search for Supermemory, and select it. 3. You'll be prompted to paste an API key—grab yours from the Supermemory dashboard under Settings → API Keys (create a new key if you don't have one). 4. Paste the key into Switchy and click 'Connect.' 5. Switchy will verify the key and display your account status (plan tier, credit balance). 6. To test, open any Project, type '@Supermemory add a document from https://example.com/article' and send; the AI will call the Add Document tool and return a document ID. 7. Try '@Supermemory list documents' to confirm ingestion worked. 8. From now on, @mention Supermemory whenever you want the AI to save, search, or retrieve content from your knowledge base.

What teammates see: by default, memories from Supermemory are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Ingest Article

@Supermemory add a document from https://example.com/blog/post and tag it 'competitor-research'. Let me know the document ID once it's ingested.

Search Knowledge Base

@Supermemory list documents tagged 'product-specs' that mention 'authentication flow'. Show me the top three results with their IDs.

Retrieve Document Chunks

@Supermemory get the chunks for document ID 12345. Summarize the key points in three bullet points.

Check Account Usage

@Supermemory get our account status. How many credits do we have left this month?

Bulk Ingest Meeting Notes

@Supermemory add these five meeting notes as separate documents, each tagged 'sprint-23'. Here are the URLs: [paste list]. Confirm which ones succeeded.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@supermemory search my meeting notes from last week for any action items assigned to the design team

Output

Found 4 documents matching 'meeting notes' from the past 7 days. Extracted action items: • Design team to finalize mobile mockups by Friday (from 2024-01-15 standup) • Review accessibility audit findings and propose fixes (from 2024-01-16 design sync) • Update component library documentation (from 2024-01-17 all-hands) All items were tagged under the 'design-team' container. Two documents mention dependencies on engineering timelines.

Notes

This example shows Supermemory's core retrieval strength: semantic search across previously ingested documents. The MCP requires documents to have been added beforehand via Add Document or Add Documents. Search quality depends on how well your team has tagged containers and whether processing completed successfully.

Prompt

@supermemory ingest https://github.com/our-org/api-docs/blob/main/CHANGELOG.md and tag it under 'release-notes' so we can reference it later

Output

Document ingested successfully. • Document ID: doc_8x2k9p • Source: https://github.com/our-org/api-docs/blob/main/CHANGELOG.md • Container: release-notes • Status: processing Processing typically completes in 10–30 seconds. Once finished, you'll be able to search this changelog or retrieve its extracted chunks. Use Get Document to check processing status.

Notes

Add Document accepts public URLs or raw text. The MCP returns a document ID immediately, but extraction and chunking happen asynchronously. If the URL requires authentication or the content is large, processing may fail silently—always verify with Get Document. This example demonstrates the write path that feeds Supermemory's knowledge base.

Prompt

@supermemory pull the learned profile for our 'customer-feedback' container and draft a one-paragraph summary of recurring themes

Output

Retrieved profile for container 'customer-feedback' (47 documents, last updated 2024-01-18). Recurring themes: Users consistently request faster export functionality and better mobile offline support. Pricing concerns appear in 18% of feedback, primarily from small teams on the free tier. Positive sentiment clusters around the collaboration features and real-time sync. Three high-priority bugs were mentioned multiple times: CSV export truncation, notification delays, and search result ranking.

Notes

Get Profile returns Supermemory's learned summary of a container—useful for synthesis tasks. The profile's accuracy depends on document volume and tagging consistency. This example pairs the MCP's retrieval with the AI's reasoning to surface patterns. Note that profiles are computed periodically, not in real time, so very recent documents may not be reflected.

Use-case deep-dives

Customer support knowledge lookup

When Supermemory beats a static wiki for support teams

A 6-person support team fields 40 tickets a day across Slack and email. They've built a 200-doc Notion wiki, but agents waste 8 minutes per ticket hunting the right article. Supermemory wins here because the Get Profile tool learns what each container tag (product area, customer tier) actually needs, then surfaces relevant chunks without the agent writing a search query. Ingest your Notion export with Add Documents, tag by product line, and let the profile API return the three chunks that match the ticket context. The trade-off: if your docs change hourly (release notes, incident logs), the profile bucketing lags by a few hours and you'll still need real-time search. If your knowledge base is stable and your team asks the same 20 questions in different words, Supermemory cuts lookup time in half.

Onboarding doc ingestion at scale

Bulk-loading a new hire's reading list in one call

A 12-person engineering team onboards two developers a quarter. Each new hire gets a 60-doc reading list: architecture decisions, runbooks, style guides, and past postmortems. The hiring manager used to Slack-DM links one at a time; now they export the list as a CSV and call Add Documents once with 60 URLs. Supermemory processes them async, returns a batch result with any failed URLs (paywalled Medium posts, broken links), and the new hire's container tag holds the entire corpus by day two. The API key auth means the manager runs this from a Retool dashboard without OAuth friction. The boundary: if your onboarding docs live in Google Drive with per-file permissions, Supermemory can't crawl them—you'll need to export to public URLs or plain text first. For public or pre-exported content, this beats manually copy-pasting into a chat context window.

Sprint retro insight extraction

Mining 40 retro transcripts for recurring blockers

A 9-person product team runs biweekly retros and saves Zoom transcripts to Dropbox. After 20 sprints, the PM wants to know which blockers keep coming up. She uploads all 40 transcripts with Add Documents, tags them by quarter, then calls Get Profile with the 'blocker' container to see the bucketed themes Supermemory extracted. The profile API groups recurring phrases (deploy pipeline, design handoff, flaky tests) without her writing regex or reading 40 docs. This works because retros use consistent language and the corpus is large enough (40 docs) for the profile to find patterns. The limit: if your retros are under 10 docs or highly unstructured (off-topic chatter, no agenda), the profile won't surface useful buckets and you're better off with keyword search. For teams with 30-plus structured retros, this surfaces the top 5 blockers in under a minute.

Frequently asked

What does the Supermemory MCP do in Switchy?

It lets your AI agents ingest documents and URLs into Supermemory, then query that knowledge base during conversations. Agents can add up to 600 documents at once, retrieve chunks, check processing status, and pull learned profiles by container tag. Think of it as giving your team's AI a long-term memory layer backed by Supermemory's indexing.

Do I need admin access to connect Supermemory?

You need an API key from your Supermemory organization. Whoever generates the key controls which documents and containers the MCP can touch. If your org restricts API key creation to admins, yes—you'll need admin help. Otherwise, any member with key-generation rights can connect it.

Can the MCP search across all my Supermemory documents?

No. The MCP exposes document ingestion, retrieval by ID, and profile queries by container tag—but it doesn't include a general full-text search tool. If you need to search arbitrary terms across your knowledge base, you'll still open Supermemory's web UI or call its search API directly outside Switchy.

How does this compare to uploading files directly in Switchy?

Switchy's native file upload gives agents ephemeral context for one conversation. Supermemory persists documents, builds profiles over time, and lets you organize knowledge by container tags. Use Supermemory when you want a shared, queryable memory that survives beyond a single chat thread.

Does adding documents through the MCP count against my Supermemory plan?

Yes. Every document you ingest via the MCP consumes credits from your Supermemory organization's balance, exactly as if you'd uploaded it through their web app. The Get Account Status tool shows your current credit balance and reset date so you can monitor usage.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.