# mcp-omie

Connects an AI agent to Omie for customer, product, order, invoice, and finance operations. Useful when ERP actions should run from an agent chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/erp/omie
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-omie

## What it does

\`mcp-omie` exposes Omie through the MCP interface. Its 30 tools cover customer and product records, sales and purchase orders, invoices, service orders, bank accounts, payables, receivables, stock, and financial reports. An agent can create records, fetch data, update a sales order, or issue an invoice from an existing order.

Requests use Omie’s JSON-RPC API. Access depends on `OMIE_APP_KEY` and `OMIE_APP_SECRET`, and Omie provides a sandbox after an app is registered. Without those credentials, the server cannot authenticate with Omie.

The server is listed for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI. Claude Code can register it through `npx`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OMIE_APP_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-omie -e OMIE_APP_SECRET=<OMIE_APP_SECRET> -- npx -y @codespar/mcp-omie
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add omie --env OMIE_APP_SECRET=<OMIE_APP_SECRET> -- npx -y @codespar/mcp-omie
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "omie": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-omie"
            ],
            "env": {
                "OMIE_APP_SECRET": "<OMIE_APP_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "omie": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-omie"
            ],
            "env": {
                "OMIE_APP_SECRET": "<OMIE_APP_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OMIE_APP_SECRET=<OMIE_APP_SECRET> omie npx -y @codespar/mcp-omie
```
Replace <…> with your own values

## When to use it
- read customer records from Omie
- create products and sales orders in the ERP
- inspect invoices and financial movements
- update an existing order and create its invoice
- check stock balances and bank activity

## Example prompts
- List Omie customers and filter them by the condition in my request.
- Create an Omie sales order from the data in this project.
- Review financial movements and find unpaid accounts.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

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