Model Context Protocol
A Model Context Protocol server for Omi interaction and automation. This server provides tools to read, search, and manipulate Memories and Conversations.
Configuration
Usage with Claude Desktop
Add this to your claude_desktop_config.json
:
Examples (langchain, openai Agents, dspy)
https://github.com/BasedHardware/omi/tree/main/mcp/examples
Tools
-
get_memories
- Retrieve a list of user memories
- Inputs:
uid
(string): The user’s unique identifierlimit
(number, optional): Maximum number of memories to retrieve (default: 100)categories
(array of MemoryFilterOptions, optional): Categories of memories to retrieve (default: [])
- Returns: JSON object containing list of memories
-
create_memory
- Create a new memory
- Inputs:
uid
(string): The user’s unique identifiercontent
(string): Content of the memorycategory
(MemoryFilterOptions): Category of the memory
- Returns: Created memory object
-
delete_memory
- Delete a memory by ID
- Inputs:
uid
(string): The user’s unique identifiermemory_id
(string): ID of the memory to delete
- Returns: Status of the operation
-
edit_memory
- Edit a memory’s content
- Inputs:
uid
(string): The user’s unique identifiermemory_id
(string): ID of the memory to editcontent
(string): New content for the memory
- Returns: Status of the operation
-
get_conversations
- Retrieve a list of user conversations
- Inputs:
uid
(string): The user’s unique identifierinclude_discarded
(boolean, optional): Whether to include discarded conversations (default: false)limit
(number, optional): Maximum number of conversations to retrieve (default: 25)
- Returns: List of conversation objects containing transcripts, timestamps, geolocation and structured summaries
Debugging
You can use the MCP inspector to debug the server. For uvx installations:
Or if you’ve installed the package in a specific directory or are developing on it:
Running tail -n 20 -f ~/Library/Logs/Claude/mcp-server-omi.log
will show the logs from the server and may
help you debug any issues.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.