skip to documentation
omnidocs

your personal memory

what a connected ai app can read and save in your personal memory, the same memory as the omni iphone app, and how search works.

paused for now

Connecting AI apps to Omni is paused while we move it onto the same storage as the Omni iPhone app. It's coming back soon, with your Personal memory only: what Omni knows about you, the same memory as in the app. Until then, use the Omni app.

Your Personal memory is what Omni knows about you: your life, preferences, people, routines, health and plans. It is the same memory your friend uses in the Omni iPhone app. A fact an AI app saves there shows up in the app, and what you tell your friend in the app is there when an AI app searches it.

Over MCP, Personal is the only memory there is. Its space_id is personal, and every tool uses it when you leave space_id out. Other spaces, files, notes and personas aren't available to AI apps for now; they're coming later.

memories

A memory is one short, self-contained sentence, up to 2,000 characters, such as "They are training for a half marathon in March."

  • Topic: an optional short label (up to 60 characters, such as running). Saving a memory with the same topic replaces the older one, so facts that change stay current.
  • Kind: optional, one of profile_fact, goal, project, preference, commitment, routine, constraint, note_summary or relationship.
  • Source: each memory keeps a label of where it came from, such as Claude or Omni app.

search_memory uses the same search as your friend in the app: it matches the words you search for, then tries the longer words one by one. It is word matching, not semantic search. With an empty query, or when nothing matches, it returns your 25 most recent memories.

how a connected ai uses it

Omni gives every connected AI the same short rules when it connects:

  1. Search before advising: call search_memory and build on what's there.
  2. Save durable facts about you with remember, one short, self-contained sentence each. Never save the same fact twice.
  3. If a tool says Omni's free limit is reached, tell you in plain words.

There is no tool that changes or deletes a memory. You fix and forget memories yourself, in the Omni app or on the dashboard.

before your account is ready

An AI app gets access only once your account is set up, so everything it saves has a home. A brand-new account takes a couple of minutes; the sign-in page waits for it (Quickstart).