Skip to content

Latest commit

 

History

History
74 lines (58 loc) · 2.6 KB

File metadata and controls

74 lines (58 loc) · 2.6 KB
title Introduction
icon plug
description Connect AI assistants to your Omi data using the Model Context Protocol

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude, Cursor, and other tools interact with external data sources. Omi's MCP server gives these assistants direct access to your memories and conversations.

Semantic search across your memories and conversations Create, edit, and delete memories Browse and search full conversation transcripts

How It Works

sequenceDiagram
    participant A as AI Assistant (Claude, Cursor, etc.)
    participant M as Omi MCP Server
    participant D as Your Omi Data

    A->>M: tools/list (discover available tools)
    M-->>A: 8 tools available
    A->>M: tools/call search_memories {query: "morning routine"}
    M->>D: Semantic search via Pinecone
    D-->>M: Ranked results
    M-->>A: Memories with relevance scores
Loading

Your AI assistant connects to the Omi MCP server, discovers available tools, and calls them as needed during your conversations. All data stays within your Omi account — the MCP server authenticates via your personal API key.


Available Tools

Tool Description
get_memories List memories with optional category filtering
search_memories Semantic search across memories
create_memory Create a new memory
edit_memory Edit an existing memory
delete_memory Delete a memory
get_conversations List conversations with date/category filters
search_conversations Semantic search across conversations
get_conversation_by_id Get full conversation with transcript

See the Tools Reference for full parameter documentation.


Comparison with Developer API

Feature MCP Developer API
Purpose AI assistant integration Direct HTTP API access
Access Read/write with AI context Read & write user data
Search Semantic search built-in Filter-based queries
Use Case Claude Desktop, Cursor, AI agents Custom apps, dashboards
Best For AI-powered workflows Batch operations, integrations
For programmatic access without AI assistants, use the [Developer API](/doc/developer/api/overview) instead.