omi-mcp
Extended MCP tools for Omi REST API (https://api.omi.me).
Why This MCP?
Omi already provides an official MCP server for AI assistants. This project provides an alternative with additional capabilities:
| Feature | Official Omi MCP | This MCP Server |
|---|---|---|
| Memories | 5 tools | 5 tools |
| Conversations | 3 tools | 6 tools |
| Folders | ❌ | ✅ List folders |
| Action Items | ❌ | ✅ Full CRUD |
| API Keys | ❌ | ✅ Manage keys |
| Transport | SSE | STDIO |
What This MCP Adds
- Full Conversation Management: Create, update, delete conversations
- Action Items: Complete task/todo management (CRUD)
- Folders: List and organize folders
- API Key Management: Create and revoke API keys programmatically
- STDIO Transport: Works with Claude Desktop, Cursor, and all MCP clients
Features
This MCP server wraps the Omi REST API endpoints:
- Memories (5 tools): list, create, create-batch, update, delete
- Conversations (6 tools): list, create, create_from_segments, get, update, delete
- Folders (1 tool): list
- Action Items (5 tools): list, create, create-batch, update, delete
- API Keys (3 tools): list, create, revoke
Installation
Using uvx (recommended)
uvx omi-mcp
Using pip
pip install omi-mcp
Development
pip install -e ".[dev]"
Configuration
Authentication
Set one of these environment variables before starting the MCP server:
OMI_AUTHORIZATION_HEADER="Authorization: Bearer omi_mcp_XXXXX"
# or
AUTHORIZATION="Bearer omi_mcp_XXXXX"
# or
OMI_API_KEY="omi_mcp_XXXXX"
Usage
Running the MCP Server
# Run with stdio transport (for MCP clients)
python -m omi_mcp.server
Claude Desktop MCP Config
Add to your Claude MCP settings (claude_mcp.json):
{
"mcpServers": {
"omi-mcp": {
"command": "uvx",
"args": ["omi-mcp"]
}
}
}
Note: configure_api_key is removed. Configure auth via environment variables only. If you previously used configure_api_key(api_key="..."), set OMI_API_KEY="..." before starting the server.
Available Tools
Memories
get_memories- List all memoriescreate_memory- Create a new memorycreate_memories_batch- Create multiple memoriesupdate_memory- Update a memorydelete_memory- Delete a memory
Conversations
get_conversations- List all conversationscreate_conversation- Create a conversationcreate_conversation_from_segments- Create from transcript segmentsget_conversation- Get a conversation by IDupdate_conversation- Update a conversationdelete_conversation- Delete a conversation
Folders
get_folders- List all folders
Action Items
get_action_items- List all action itemscreate_action_item- Create a new action itemcreate_action_items_batch- Create multiple action itemsupdate_action_item- Update an action itemdelete_action_item- Delete an action item
API Keys
get_api_keys- List all API keyscreate_api_key- Create a new API keyrevoke_api_key- Revoke an API key
Development
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
Releases
Publishing is automated through GitHub Actions.
- Push a version tag like
v0.1.9 - The workflow creates a GitHub Release with built artifacts
- The same workflow publishes the package to PyPI
Metadata
Release files for omi-mcp 0.1.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| omi_mcp-0.1.13.tar.gz | 90.0 kB | Without provenance | Details for omi_mcp-0.1.13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| omi_mcp-0.1.13-py3-none-any.whl | Python 3 | none | any | Details for omi_mcp-0.1.13-py3-none-any.whl |
Total release size: 101.8 kB
Release files / omi_mcp-0.1.13.tar.gz
| Download URL | omi_mcp-0.1.13.tar.gz |
|---|---|
| Size | 90.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c721fdbe67d28c3fd1944a52f3bb64a49efa8f36450b7722b8c1360e69d8eed
|
|
BLAKE2b-256 checksum How to use checksums |
e2e8e3145b7781cd199476aeef16e2accc320cce94d7b8a76c248ccf423e75db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / omi_mcp-0.1.13-py3-none-any.whl
| Download URL | omi_mcp-0.1.13-py3-none-any.whl |
|---|---|
| Size | 11.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e1ce2cca7e32b3c040292023540bae23ce2fa9c2591aae061df72b8186551acd
|
|
BLAKE2b-256 checksum How to use checksums |
986a5c882abd4708abdaef23b8b2c82a66865cea090effcc08ec9222fbd18e6d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Security for omi-mcp 0.1.13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.