mydata-mcp

mydata-mcp

Read-only MCP server for the Greek AADE myDATA e-books API.

Ask Claude (or any MCP client) questions about your business's invoices, income,and expenses — in plain language. All myDATA codes (document types, VATcategories, E3 classifications) are decoded into human-readable bilingual labelsbefore they ever reach the model.

⚠️ Unofficial project — not affiliated with AADE. Strictly read-only: nowrite endpoint of the myDATA API is ever called.

What can you ask?

• "Ποια τιμολόγια έλαβα από προμηθευτές τον Ιούλιο;"
• "What was my gross margin in July 2026?"
• "Who are my top 5 suppliers by spend this quarter?"
• "Show me all credit notes I issued last month."

Features

• 4 tools — received documents, transmitted documents, income summary,expense summary, with date/VAT/type filters and transparent pagination.
• 3 resources — full myDATA code tables (invoice types, VAT categories,classifications) the model can consult on demand.
• 1 prompt — monthly_review generates a complete monthly business review.
• Battle-tested XML handling — survives myDATA's escaped/nested andoccasionally malformed XML responses via lxml recovery mode.
• Compact output — clean, typed JSON instead of raw XML dumps; details areopt-in per call, so token usage stays low.

Architecture

flowchart LR
    LLM["MCP client<br/>(Claude Desktop / Claude Code)"] <-->|stdio| S[server.py]
    S --> C["client.py<br/>httpx · auth · pagination"]
    C <-->|HTTPS/XML| A[("AADE myDATA API")]
    C --> P["parser.py<br/>xmltodict + lxml recovery"]
    P --> N["normalizer.py<br/>pydantic + code decoding"]
    N -->|compact JSON| S

Quickstart

1. Get myDATA credentials

Register at mydata.aade.gr to obtain youruser_id and subscription_key.

2. Configure your MCP client

Claude Desktop (claude_desktop_config.json) or Claude Code(claude mcp add):

{
  "mcpServers": {
    "mydata": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nikagabriel741agent/myData-MCP-Server", "mydata-mcp"],
      "env": {
        "MYDATA_USER_ID": "your-user-id",
        "MYDATA_SUBSCRIPTION_KEY": "your-subscription-key"
      }
    }
  }
}

For a local checkout, use "args": ["--from", "/path/to/mydata-mcp", "mydata-mcp"].

3. Ask away

Try the built-in prompt: monthly_review(month=7, year=2026).

Tools

Common parameters: date_from / date_to (ISO or dd/MM/yyyy),counterpart_vat, invoice_type, include_details, max_results.Every response carries page_info: {has_more, next_mark}.

Resources

Configuration

Development

uv sync          # install
uv run pytest    # test (all HTTP mocked — no credentials needed)
uv run ruff check .

License

MIT