# Omie

Connects an AI agent to Omie for payables, receivables, bank movements, customers and documents. Useful for bookkeeping tasks and reconciliation.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: mcp-dir
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mcp-dir/omie-mcp
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/omie

## What it does

Omie connects an agent to Omie through its JSON API. It can read and edit payables and receivables, register customers or suppliers, inspect financial movements, checking accounts, categories, projects and issued invoices.

The server also handles write operations: create or settle a payable, cancel a payment, move funds between company accounts, and attach a PDF or PNG to an Omie document. It uses MCP over HTTP at `https://api.mcp.ai/p_omie`, with sign-in through a magic link. Account deletion is permanent, so deletion requests need a careful review.

## Requirements
- Remote server: `https://api.mcp.ai/p_omie`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http omie-mcp https://api.mcp.ai/p_omie
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add omie --url https://api.mcp.ai/p_omie
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "omie": {
            "url": "https://api.mcp.ai/p_omie"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "omie": {
            "type": "http",
            "url": "https://api.mcp.ai/p_omie"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http omie https://api.mcp.ai/p_omie
```

## When to use it
- create a payable or receivable
- settle a payment or customer receipt
- review movements for bank reconciliation
- transfer funds between company accounts
- attach proof to a financial document

## Example prompts
- Create a R$ 500 payable in Omie for Acme Ltda, due on the 30th.
- List financial movements settled during the last 7 days for bank reconciliation.
- Attach this PDF to the payable I just created.

## Similar
- [mcp-omie](https://affpapa.org/en/nevibecode/mcp/mcp-omie.md) — MCP server · ★ 274
- [QuickBooks Automation](https://affpapa.org/en/nevibecode/skills/quickbooks-automation.md) — skill · 4700 installs
- [Invoice Automation](https://affpapa.org/en/nevibecode/skills/invoice-automation.md) — skill · 4700 installs
- [close-month](https://affpapa.org/en/nevibecode/skills/close-month.md) — skill · 1800 installs
- [paypal-import](https://affpapa.org/en/nevibecode/skills/paypal-import.md) — skill · 368 installs
- [stripe-import](https://affpapa.org/en/nevibecode/skills/stripe-import.md) — skill · 364 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
