Skip to main content
MCP server CX Codex

Omi — Claude Code MCP server: what it does, how to install

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.

no license updated 2026-10-29

Open on GitHub

What Omi 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.

What it helps with

  • 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 for the agent

  • Show my last 100 Omi memories
  • Create a memory: release moved to Friday
  • Delete the memory with the memory_id from the previous answer

How to install Omi

Install

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Omi

How do I install Omi in Claude Code?

Go with uvx: install uv first, skip any separate package install because uvx fetches mcp-server-omi on first run. Then register a server whose command is uvx, whose argument is mcp-server-omi, and whose env carries OMI_API_KEY set to your omi_mcp_... key.

What does Omi do?

It links an MCP client to Omi memory: listing memories, creating, editing and deleting them, plus fetching conversations with transcripts and summaries.

How is this different from the hosted endpoint?

This package is a local stdio process and is marked deprecated. The hosted endpoint at https://api.omi.me/v1/mcp accepts Streamable HTTP connections with OAuth or an MCP key and needs no local process.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open