Nextora MCP Server

Connect your AI assistant (Claude Desktop, Cursor, Cline, etc.) to Nextora to record transactions and analyze receipts by chatting.

Tools

| Tool | Description | |---|---| | list_categories | List available income/expense categories | | add_transaction | Record a new income or expense | | upload_receipt | Analyze a receipt image and auto-record the transaction | | get_balance | Get income/expense/net summary for a date range | | list_transactions | List recent transactions with filters |

Setup

1. Generate an API Key

Log in to Nextora → Settings → API Keys → Generate Key. Copy the key — it is shown once only.

2. Configure Claude Desktop

Edit ~/.claude/settings.json (or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "nextora": {
      "command": "npx",
      "args": ["-y", "nextora-mcp"],
      "env": {
        "NEXTORA_API_URL": "https://your-nextora-domain.com/api",
        "NEXTORA_API_KEY": "nxt_your_key_here"
      }
    }
  }
}

3. Or run with Docker

docker run --rm -i \
  -e NEXTORA_API_URL="https://your-domain/api" \
  -e NEXTORA_API_KEY="nxt_your_key_here" \
  blacksptech/nextora-mcp:latest

Config ที่ user ใช้กับ Claude Desktop { "mcpServers": { "nextora": { "command": "docker", "args": ["run", "--rm", "-i", "-e", "NEXTORA_API_URL=https://your-domain.com/api", "-e", "NEXTORA_API_KEY=nxt_xxx", "blacksptech/nextora-mcp:latest" ] } } }

Example conversations

"บันทึกค่ากาแฟ 80 บาท วันนี้"
"Add a food expense of 80 baht for coffee today"

"ส่งรูปใบเสร็จนี้แล้วบันทึกเลย /home/user/receipt.jpg"
"Upload this receipt and record it: /Users/me/Downloads/receipt.png"

"ยอดรายรับรายจ่ายเดือนนี้เป็นยังไง"
"What's my income vs expense this month?"

"แสดงรายการ 10 รายการล่าสุด"
"Show my last 10 transactions"