fio-connector - SKILL.md Agent Skill

name: fio-connector description: Use when working with Fio banka — bank balance, transactions, payments, reports, or when user mentions Fio, bankovní účet, zůstatek, transakce, platební příkaz. Use when user mentions bank account management or Czech banking.

Fio Connector

CLI tool and MCP server for Fio banka API.

When to use CLI vs MCP

MCP tools: Use in Claude Code conversations for natural language queries
CLI: Use for automation, cron jobs, batch operations, or when MCP is unavailable

CLI Commands

fio balance                          # Current account balance
fio transactions                     # Last 30 days
fio transactions --last 7            # Last 7 days
fio transactions --from 2026-03-01 --to 2026-03-20
fio transactions --new               # Since last download
fio search "Google"                   # Search transactions
fio statement 2026 3                  # Official statement #3/2026
fio upload payments.abo               # Upload ABO payment file
fio pay 1234567890/0100 50000 --vs 123 --message "Invoice"
fio export --format json -o .         # Export transactions
fio report monthly                    # Monthly CFO report
fio report yearly                     # Yearly summary
fio report categories                 # Category cross-tabulation

Integration with fakturoid-connector

These two connectors work together:

Generate ABO: fakturoid abo --due-date 2026-03-21
Upload to bank: fio upload output/expenses_2026-03-21.abo
Or direct payment: "Zaplat fakturu N202603044" → finds expense in Fakturoid → creates payment in Fio

Transaction categorization

Create categories.yaml in working directory:

categories:
  - name: Mzdy
  - name: Najem
  - name: Marketing

rules:
  - match: {bank_code: "0710"}
    category: Odvody
  - match: {vs_prefix: "746227"}
    category: Mzdy
  - match: {message_contains: "Google"}
    category: Marketing

Setup

Requires .env:

FIO_API_TOKEN=your_64_char_token

MCP Server

Add to .mcp.json:

{
  "mcpServers": {
    "fio": {
      "command": "/path/to/fio-connector/.venv/bin/python",
      "args": ["-m", "fio_connector.mcp_server"],
      "cwd": "/path/to/fio-connector"
    }
  }
}