# Omi

Hands an MCP client the memories and conversations stored in Omi: five tools over a local stdio process, authenticated with a key from the app.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: basedhardware
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basedhardware/omi/tree/HEAD/mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/omi

## What it does

The package `mcp-server-omi` runs a stdio server on your machine and connects an MCP client to Omi. Five tools ship with it: `get_memories` and `get_conversations` return lists, while `create_memory`, `edit_memory` and `delete_memory` act on a single record found by `memory_id`. Conversations come back with transcripts, timestamps, geolocation and summaries. Memory lists default to 100 entries, conversations to 25, and discarded ones are skipped unless you ask for them.

Version 0.2.0 marks the package deprecated. The replacement is a hosted endpoint at `https://api.omi.me/v1/mcp` that speaks Streamable HTTP: OAuth or an MCP key, nothing running locally. This stdio build stays published for clients that need a local bridge anyway.

Create a key inside the Omi app at `Settings → Developer Settings → MCP Server → API Keys`, or on macOS under `Use omi memory anywhere` and `Manual installation`; the `omi_mcp_...` value shows once. Send it with each tool call, or set `OMI_API_KEY`. With a self-hosted backend you set `OMI_API_BASE_URL`, and that string must end in `/v1/mcp/` — it is the REST base, not the hosted endpoint clients connect to.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- pull Omi memories into the agent context
- save a memory from a coding session
- edit or delete a record by `memory_id`
- fetch conversation transcripts with their summaries
- move a client off the local stdio package onto the hosted endpoint

## Example prompts
- Show my last 100 Omi memories
- Create a memory: release moved to Friday
- Delete the memory with the `memory_id` from the previous answer

## Similar
- [DeerDawn](https://affpapa.org/en/nevibecode/mcp/deerdawn.md) — MCP server · 2575 installs
- [conxt](https://affpapa.org/en/nevibecode/mcp/conxt.md) — MCP server · 263 installs
- [DejaView](https://affpapa.org/en/nevibecode/mcp/dejaview.md) — MCP server · 174 installs
- [groove](https://affpapa.org/en/nevibecode/skills/groove.md) — skill · 633 installs
- [groove-utilities-memory-log-daily](https://affpapa.org/en/nevibecode/skills/groove-utilities-memory-log-daily.md) — skill · 583 installs
- [opencontext](https://affpapa.org/en/nevibecode/skills/opencontext.md) — skill · 371 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
