Metadata-Version: 2.4
Name: omi-mcp
Version: 0.1.1
Summary: Extended MCP tools for Omi REST API
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# omi-mcp

Extended MCP tools for Omi REST API (https://api.omi.me).

## 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)

```bash
uvx omi-mcp --with OMI_API_KEY=omi_mcp_your_token_here
```

### Using pip

```bash
pip install omi-mcp
```

### Development

```bash
pip install -e ".[dev]"
```

## Configuration

### Authentication

The Omi API uses Bearer token authentication:

```
Authorization: Bearer omi_mcp_XXXXX
```

Set your API key via environment variable:

```bash
export OMI_API_KEY=omi_mcp_your_token_here
```

Get your API key from https://omi.me (Settings → Developer → Create Key)

## Usage

### Running the MCP Server

```bash
# Set the API key
export OMI_API_KEY=omi_mcp_your_token

# Run with stdio transport (for MCP clients)
python -m omi_mcp.server

# Or use uvx
uvx omi-mcp --with OMI_API_KEY=omi_mcp_your_token
```

### Claude Desktop MCP Config

Add to your Claude MCP settings (`claude_mcp.json`):

```json
{
  "mcpServers": {
    "omi-mcp": {
      "command": "uvx",
      "args": ["omi-mcp", "--with", "OMI_API_KEY=omi_mcp_your_token"]
    }
  }
}
```

### Available Tools

#### Memories
- `get_memories` - List all memories
- `create_memory` - Create a new memory
- `create_memories_batch` - Create multiple memories
- `update_memory` - Update a memory
- `delete_memory` - Delete a memory

#### Conversations
- `get_conversations` - List all conversations
- `create_conversation` - Create a conversation (returns full response from Omi)
- `create_conversation_from_segments` - Create from transcript segments
- `get_conversation` - Get a conversation by ID
- `update_conversation` - Update a conversation
- `delete_conversation` - Delete a conversation

#### Folders
- `get_folders` - List all folders

#### Action Items
- `get_action_items` - List all action items
- `create_action_item` - Create a new action item
- `create_action_items_batch` - Create multiple action items
- `update_action_item` - Update an action item
- `delete_action_item` - Delete an action item

#### API Keys
- `get_api_keys` - List all API keys
- `create_api_key` - Create a new API key
- `revoke_api_key` - Revoke an API key

## Development

```bash
# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest
```
