Omi MCP Server

@fourcolors

About Omi MCP Server

mcp server for omi

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "omi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@fourcolors/omi-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Omi MCP Server?

An MCP server that provides tools for reading and creating conversations and memories via the Omi API. It is built for developers using MCP-compatible clients such as Claude Desktop or Cursor who need programmatic access to Omi data.

How to use Omi MCP Server?

Install automatically via Smithery or clone the repository, install dependencies with npm install, and create a .env file with API_KEY and APP_ID. Build with npm run build, start with npm run start, and configure your MCP client to use the compiled dist/index.js via stdio transport.

Key features of Omi MCP Server

Read conversations from Omi with pagination and status filters
Read memories from Omi with pagination
Create new conversations in Omi with text source metadata
Create new memories in Omi from text or explicit memory objects
Built-in logging to console and a log file for debugging

Use cases of Omi MCP Server

Fetch and summarize user conversations through a Claude or Cursor assistant
Automatically create Omi conversation records from transcribed audio or chat messages
Retrieve and analyze user memories as part of a larger AI workflow
Bulk-create structured memories from meeting notes or journal entries

FAQ from Omi MCP Server

What runtime or dependencies does the server require?

Node.js and npm. After cloning, run npm install and set the API_KEY and APP_ID environment variables in a .env file.

What transport mechanism does the server use?

The server uses stdio transport. Claude Desktop and Cursor configurations point to the built dist/index.js file with no additional arguments.

Where does the data live?

All data resides in the Omi API service. The server acts as a bridge, relaying requests from the MCP client to the Omi API and returning the results.

What tools does the server expose?

Four tools: read_omi_conversations, read_omi_memories, create_omi_conversation, and create_omi_memories. Each has documented parameters such as user_id, limit, offset, and text_source.

How can I test the server without a full client setup?

A test client (test-mcp-client.js) is included. Run it after building to get an interactive menu that lets you list conversations, list memories, create a conversation, and quit. It uses a default test user ID (test-user-123).

Frequently asked questions

What runtime or dependencies does the server require?

Node.js and npm. After cloning, run `npm install` and set the `API_KEY` and `APP_ID` environment variables in a `.env` file.

What transport mechanism does the server use?

The server uses stdio transport. Claude Desktop and Cursor configurations point to the built `dist/index.js` file with no additional arguments.

Where does the data live?

All data resides in the Omi API service. The server acts as a bridge, relaying requests from the MCP client to the Omi API and returning the results.

What tools does the server expose?

Four tools: `read_omi_conversations`, `read_omi_memories`, `create_omi_conversation`, and `create_omi_memories`. Each has documented parameters such as `user_id`, `limit`, `offset`, and `text_source`.

How can I test the server without a full client setup?

A test client (`test-mcp-client.js`) is included. Run it after building to get an interactive menu that lets you list conversations, list memories, create a conversation, and quit. It uses a default test user ID (`test-user-123`).

Comments

Basic information

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.