Omi MCP Server

A custom MCP (Model Context Protocol) server that connects Claude to the full Omi platform - 38 tools covering memories, conversations, action items, goals, transcript editing, speaker management, and more.

Why This Exists

Omi provides an official MCP server using SSE (Server-Sent Events) transport. Two problems:

1. Firewall issues on managed devices. SSE maintains persistent long-lived HTTP connections. On Windows, this triggers "Allow Node.js through Windows Firewall?" prompts. On a work-managed device, that's a non-starter.

2. No Internal API access. The official MCP only uses the Developer API key. It can't edit transcript text, assign speakers to segments, query conversations by status, reprocess conversations, or manage apps/templates - all of which require Firebase authentication.

This server solves both:

• stdio transport - standard outbound HTTPS requests only, no persistent connections, no firewall prompts
• Dual authentication - Developer API key for standard CRUD + Firebase tokens for Internal API access, on a single server

Prerequisites

• Node.js 24+ (uses built-in fetch() - zero npm dependencies)
• Omi account with the Omi mobile app installed
• Claude Code or Claude Desktop (any MCP-compatible client works)

Setup

1. Get Your Credentials

You need three values:

Developer API Key

1. Open the Omi mobile app
2. Go to Settings > Developer
3. Tap "Create Key"
4. Copy the key (shown once, starts with omi_dev_)

Keys are case-sensitive - it's omi_dev_ lowercase, not Omi_dev_.

Firebase Refresh Token

This gives access to Omi's Internal API (transcript editing, speaker assignment, conversation lifecycle). If you only need the Developer API tools, you can skip this.

1. Open omi.me in Chrome and log in
2. Open DevTools (F12)
3. Go to the Application tab
4. In the left sidebar, expand IndexedDB
5. Find firebaseLocalStorageDb
6. Click into the object store
7. Find the entry with your user data
8. Navigate to: value > stsTokenManager > refreshToken
9. Copy the refresh token string

The refresh token doesn't expire unless you change your password or explicitly revoke sessions. You only need to do this once.

Firebase API Key

This identifies Omi's Firebase project. It's not a secret (it's embedded in the web app), but you need the correct one to avoid PROJECT_NUMBER_MISMATCH errors.

Important: Omi has two Firebase projects. The key in the GitHub repo (AIzaSyC1U6S-...) is the dev project. Production users need the production key. Check the Omi web app's network requests or source to find the current production key.

2. Register the Server

Claude Code (CLI)

claude mcp add --scope user omi \
  node /path/to/omi-mcp-server.js \
  -e OMI_DEV_API_KEY=omi_dev_your_key \
  -e OMI_FIREBASE_API_KEY=your_firebase_api_key \
  -e OMI_FIREBASE_REFRESH_TOKEN=your_refresh_token

Replace /path/to/ with the actual path to omi-mcp-server.js.

Claude Desktop

Add to your config file (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "omi": {
      "command": "node",
      "args": ["/path/to/omi-mcp-server.js"],
      "env": {
        "OMI_DEV_API_KEY": "omi_dev_your_key",
        "OMI_FIREBASE_API_KEY": "your_firebase_api_key",
        "OMI_FIREBASE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

3. Verify

After registration, your MCP client should list all 38 tools. Try a simple read operation:

Get my latest 5 Omi memories

Tool Reference

Developer API Tools (API Key Auth)

These tools use your OMI_DEV_API_KEY for authentication.

Memories (5 tools)

Tool	Description
get_memories	List memories with pagination and category filter
create_memory	Create a single memory (fact, insight, note)
create_memories_batch	Create up to 25 memories at once
update_memory	Update content, visibility, tags, or category
delete_memory	Permanently delete a memory

Conversations (6 tools)

Tool	Description
get_conversations	List completed conversations with filters
get_conversation	Get a single conversation by ID (with optional transcript)
create_conversation	Create from plain text (runs full processing pipeline)
create_conversation_from_segments	Create from structured transcript segments with speaker/timing data
update_conversation	Update title or discard status
delete_conversation	Permanently delete a conversation

Action Items (5 tools)

Tool	Description
get_action_items	List action items with status/date/conversation filters
create_action_item	Create a standalone action item
create_action_items_batch	Create up to 50 action items at once
update_action_item	Update description, completion status, or due date
delete_action_item	Permanently delete an action item

Goals (6 tools)

Tool	Description
get_goals	List active goals (boolean, scale, or numeric types)
create_goal	Create a new goal (max 3 active)
update_goal	Update title, values, or unit
update_goal_progress	Quick progress value update
get_goal_history	Get progress history over time (up to 365 days)
delete_goal	Delete a goal

Internal API Tools (Firebase Auth)

These tools use Firebase ID tokens. They require OMI_FIREBASE_API_KEY and OMI_FIREBASE_REFRESH_TOKEN.

Conversation Lifecycle (3 tools)

Tool	Description
get_conversations_by_status	List conversations by status: in_progress, processing, merging, completed, failed
process_in_progress_conversation	Force-process a stuck in_progress conversation
reprocess_conversation	Regenerate title/overview/action items from transcript

Search & Merge (2 tools)

Tool	Description
search_conversations	Full-text search across all conversations
merge_conversations	Combine fragmented recordings into one conversation

Transcript Editing (2 tools)

Tool	Description
edit_segment_text	Fix transcription errors in a specific segment
assign_segments	Bulk assign speaker identity (is_user or person_id)

App/Template Management (5 tools)

Tool	Description
get_enabled_apps	List installed apps/templates
get_app_details	Get full app details by ID
enable_app	Install an app/template
disable_app	Disable without deleting
delete_app	Permanently delete (user-owned only)

People/Speaker Profiles (4 tools)

Tool	Description
get_people	List all speaker profiles with speech samples
create_person	Create a new speaker profile
update_person_name	Rename a speaker profile
delete_person	Delete profile and all speech samples

Troubleshooting

"Allow Node.js through Windows Firewall?" prompt

You're using the SSE-based official server, not this one. This stdio server makes standard outbound HTTPS requests only - no firewall prompts.

PROJECT_NUMBER_MISMATCH error

You're using the wrong Firebase API key. Omi has two Firebase projects (dev and production). Make sure your OMI_FIREBASE_API_KEY matches the Firebase project your account is on. If your account is on production omi.me, you need the production key - not the dev key from the GitHub repo.

API key not working / 401 errors

• Dev API keys are case-sensitive: omi_dev_ (lowercase), not Omi_dev_
• Check that the key is correctly set in your environment variables
• Verify the key hasn't been revoked in the Omi mobile app

assign_segments returns 404

The endpoint URL format matters. This server uses the Internal API path (/v1/conversations/{id}/segments/assign), not the Developer API path (/v1/dev/user/conversations/{id}/segments/assign). If you've modified the code, verify the path.

Firebase token refresh fails

Your refresh token may have been revoked (password change, session revocation). Re-extract it from omi.me browser IndexedDB following the setup steps above.

Conversations stuck in "processing" status

Use get_conversations_by_status to find them, then process_in_progress_conversation or reprocess_conversation to push them through. This commonly happens after Bluetooth disconnects or app crashes.

Environment Variables

Variable	Required	Description
OMI_DEV_API_KEY	Yes	Omi Developer API key (omi_dev_xxx)
OMI_FIREBASE_API_KEY	For Internal API tools	Firebase project API key
OMI_FIREBASE_REFRESH_TOKEN	For Internal API tools	Firebase refresh token from browser
OMI_API_BASE_URL	No	Override API base URL (default: https://api.omi.me)

License

MIT - see LICENSE.