Skip to main content

​
Overview

Omnara provides an MCP (Model Context Protocol) server that integrates with various AI coding assistants including Claude Desktop, Cursor, Cline, Windsurf, and more.

​
Supported Clients

Claude Desktop

Stdio transport

Claude Code

Stdio transport

Cursor

HTTP/Stdio transport

Cline

Stdio transport

Windsurf

SSE transport

Custom

Any MCP client

​
Quick Setup

​
Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows): 
{
  "mcpServers": {
    "omnara": {
      "command": "omnara",
      "args": ["mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

​
Cursor

Add to your Cursor settings or .cursorrules: 
{
  "mcpServers": {
    "omnara": {
      "type": "stdio",
      "command": "omnara",
      "args": ["mcp", "--api-key", "YOUR_API_KEY", "--git-diff"]
    }
  }
}

​
Using pipx

If you installed Omnara with pipx: 
{
  "mcpServers": {
    "omnara": {
      "command": "pipx",
      "args": ["run", "--no-cache", "omnara", "mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

​
Available Tools

When you add Omnara as an MCP server, AI agents get access to these tools:
  • log_step
  • ask_question
  • end_session
  • approve (optional)
Purpose: Log progress updatesUse case: Track what the agent is doing
  • “Analyzing codebase structure…”
  • “Found 5 files to review”
  • “Making changes to authentication.py”

​
Advanced Configuration

​
Enable Git Diff Tracking

{
  "mcpServers": {
    "omnara": {
      "command": "omnara",
      "args": ["mcp", "--api-key", "YOUR_API_KEY", "--git-diff"]
    }
  }
}
Automatically captures code changes with every message.

​
Permission Tool Mode

{
  "mcpServers": {
    "omnara": {
      "command": "omnara",
      "args": [
        "mcp",
        "--api-key", "YOUR_API_KEY",
        "--permission-tool",
        "--disable-tools"
      ]
    }
  }
}
Use Omnara purely for permission prompts, disabling other tools to reduce overhead.

​
Resume Existing Session

{
  "mcpServers": {
    "omnara": {
      "command": "omnara",
      "args": [
        "mcp",
        "--api-key", "YOUR_API_KEY",
        "--agent-instance-id", "abc-123-def-456"
      ]
    }
  }
}
Continue an existing session instead of creating a new one.

​
How It Works

1

Client Starts MCP Server

Your AI client (Claude Desktop, Cursor, etc.) launches omnara mcp as a subprocess
2

Tools Registered

Omnara registers available tools with the MCP client via stdio protocol
3

Agent Uses Tools

AI agent calls tools as needed:
  • log_step("Analyzing code...")
  • ask_question("Proceed with changes?")
4

Synced to Dashboard

All messages and questions appear in real-time on your Omnara dashboard
5

User Responds

You can respond to questions from:
  • Web dashboard
  • Mobile app
  • Any device with Omnara access
6

Response Delivered

Your response is sent back to the AI agent via the MCP server

​
Use Cases

Monitor what Claude Desktop is doing from your phone. Respond to questions while away from your computer.
All Claude Desktop conversations are logged to your Omnara dashboard. Review what agents did, even after closing the app.
Start work in Cursor on your laptop, continue monitoring on your phone, respond from your tablet.
Share agent session links with teammates. Collaborate on AI-assisted development.
Approve Claude Code actions remotely through dashboard instead of local terminal prompts.

​
Troubleshooting

Check:
  1. Omnara is installed: omnara --version
  2. API key is valid: omnara mcp --api-key YOUR_KEY (test manually)
  3. Config file syntax is correct (valid JSON)
  4. No typos in command or args
Debug:
# Test MCP server manually
omnara mcp --api-key YOUR_KEY

# Check logs
# Claude Desktop: ~/Library/Logs/Claude/mcp.log
Causes:
  • Client doesn’t support MCP tools
  • Configuration not reloaded
  • Wrong transport type for client
Fix:
  1. Restart your AI client
  2. Check client supports MCP stdio
  3. Verify tool registration in client logs
Causes:
  • Wrong API key
  • Network/firewall blocking
  • Wrong base URL (for self-hosted)
Fix:
# Test API key manually
curl -H "Authorization: Bearer YOUR_KEY" \
  https://agent.omnara.com/api/v1/auth/verify

omnara mcp Command

Complete MCP server documentation

Python SDK

Build custom MCP integrations