Model Context Protocol Server
v1.2.0 - Oxygen Payments

AI Integration for
Oxygen Pelatologio

Manage invoices, contacts, and products using natural language. Full MyData/AADE integration for Greek businesses.

Get Started Learn about Oxygen
NEW

What's New in v1.2.0

Oxygen Payments

Create and manage payment links for your customers. Send requests via email and get paid online.

Multi-Company Support

Manage multiple Oxygen accounts from a single MCP server. Perfect for accountants and business groups.

Revenue Analytics

Daily and monthly revenue reports. Get instant insights across all your companies.

22 AI Tools

Contacts, invoices, products, credit notes, quotes, payments, and more. All via natural language.

Everything you need

Powerful tools for managing your Greek business through AI

Contacts Management

List, search, and create customers and suppliers. Find contacts by VAT number, email, or name.

Invoice Creation

Generate invoices automatically sent to MyData/AADE. Full compliance with Greek tax regulations.

Product Catalog

Access your entire product and service catalog. Create new items with proper VAT categories.

Credit Notes

Issue credit notes linked to original invoices with automatic MyData transmission.

Quotes & Proformas

Create quotes and proforma invoices for customers before finalizing sales.

MyData Integration

All documents automatically transmitted to AADE. Get MARK numbers and QR codes.

Quick Installation

Get started in under 5 minutes

1

Get your Oxygen API Key

Log in to app.pelatologio.gr, navigate to Settings → API and copy your API key.

2

Configure Claude Desktop

Add the following to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "oxygen": {
      "command": "npx",
      "args": ["-y", "@oxgn/mcp-oxygen"],
      "env": {
        "OXYGEN_API_KEY": "your-api-key-here"
      }
    }
  }
}
3

Restart Claude Desktop

Quit Claude Desktop completely (Cmd+Q / Ctrl+Q) and reopen it. The Oxygen tools will now be available!

v1.1.0 Feature

Multi-Company Setup

Manage multiple Oxygen accounts from a single MCP server. Perfect for accountants, bookkeepers, and business groups.

1

Create Companies Config File

Create a JSON file at ~/.config/mcp-oxygen/companies.json:

{
  "companies": {
    "acme": {
      "name": "ACME AE",
      "api_key": "sk-xxx-acme-key",
      "tags": ["retail", "athens"]
    },
    "globex": {
      "name": "Globex EPE",
      "api_key": "sk-xxx-globex-key",
      "tags": ["wholesale", "thessaloniki"]
    },
    "initech": {
      "name": "Initech IKE",
      "api_key": "sk-xxx-initech-key",
      "tags": ["services"]
    }
  },
  "default": "acme"
}

Config File Locations (checked in order):

  1. OXYGEN_COMPANIES_CONFIG environment variable
  2. ~/.config/mcp-oxygen/companies.json
  3. ./companies.json (current directory)
2

Update Claude Desktop Config

Remove the OXYGEN_API_KEY from env (the MCP will auto-detect your companies.json):

{
  "mcpServers": {
    "oxygen": {
      "command": "npx",
      "args": ["-y", "@oxgn/mcp-oxygen"]
      // No env needed - auto-detects companies.json
    }
  }
}
3

Start Using Multi-Company Features

Restart Claude Desktop and try these commands:

→ "List all my companies"
→ "What's today's revenue for all companies?"
→ "Show ACME's invoices from last week"
→ "Compare monthly revenue across retail companies"

Available Tools

22 powerful tools at your disposal

Tool Description Category
list_companies List all configured companies NEW Multi-Company
get_daily_revenue Get daily revenue for one or all companies NEW Analytics
get_monthly_revenue Get monthly revenue summary NEW Analytics
list_contacts List all contacts with optional filtering Contacts
get_contact Get details of a specific contact Contacts
create_contact Create a new customer or supplier Contacts
list_invoices List invoices with date filtering Invoices
get_invoice Get full details of an invoice Invoices
create_invoice Create invoice (sent to MyData) Invoices
list_products List all products and services Products
get_product Get details of a product Products
create_product Create a new product or service Products
list_credit_notes List all credit notes Credit Notes
create_credit_note Create credit note (sent to MyData) Credit Notes
list_oxygen_payments NEW List all payment links Payments
get_oxygen_payment NEW Get details of a payment link Payments
create_oxygen_payment NEW Create a payment link for customer Payments
list_notices List quotes and proformas Quotes
create_notice Create a quote or proforma Quotes
list_taxes List available VAT rates Reference
list_payment_methods List payment methods Reference
list_numbering_sequences List invoice numbering series Reference

Example Conversations

See what you can ask Claude

"Show me all my customers"

Lists all your contacts marked as customers with their VAT numbers, addresses, and contact details.

"Find the customer with VAT 123456789"

Searches for and displays the contact with that VAT number, including all their details.

"What were my sales last month?"

Fetches all invoices from the previous month and summarizes your total revenue.

v1.2.0

Multi-Company Examples

"What's today's revenue for all companies?"

Returns revenue summary for each configured company with invoice counts and totals.

"Compare this month's revenue across all retail companies"

Uses company tags to filter and compare revenue across companies tagged as "retail".

Important: Creating invoices and credit notes sends real documents to MyData (AADE). Use with caution in production!