Cashly

Cashly API and MCP Server

Expense, EMI and debt tracker with a REST API and a remote MCP server.
Let ChatGPT, Claude, n8n or your own AI agent read and log your money, in any currency.

Website · MCP guide · API docs · Google Play · MCP Registry

What is Cashly?

Cashly is a free personal finance app for Android and the web, used worldwide in any currency and time zone. It tracks expenses and income, real balances for banks, cards and wallets, EMIs and loans, money lent and borrowed, and bills before they are due. It never asks for a bank login, never reads SMS and has no ads.

This repository is the public home of Cashly's developer surface:

The server is hosted by Corenexis. There is nothing to install or run: point your client at the URL.

What you can do with it

Ask an assistant things like:

• "Add 450 for groceries paid by UPI today."
• "How much did I spend on food this month compared with last month?"
• "Which bills are due in the next 7 days?"
• "Record this month's car loan EMI as paid."
• "Who owes me money, and how much is left on each?"
• "Create a credit card called Travel Card with a 2,00,000 limit."

Every action works on the signed-in user's own data, and nothing moves real money: recording a payment only updates the tracker.

Quick start

1. Get access

• ChatGPT and other OAuth clients: no key needed. You sign in to Cashly and approve access.
• Everything else: create an API key in Cashly under Settings -> Developer -> API keys. Keys look like cn_cashly_... and can be read and write or read only. Up to 5 keys per account.

API, MCP and webhook access are part of the Cashly Pro and Pro Plus plans.

2. Connect your client

claude mcp add --transport http cashly https://cashly.corenexis.com/api/mcp \
  --header "x-api-key: cn_cashly_your_key_here"

{
  "mcpServers": {
    "cashly": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://cashly.corenexis.com/api/mcp",
        "--header", "x-api-key:cn_cashly_your_key_here"
      ]
    }
  }
}

{
  "mcpServers": {
    "cashly": {
      "url": "https://cashly.corenexis.com/api/mcp",
      "headers": { "x-api-key": "cn_cashly_your_key_here" }
    }
  }
}

# List the tools
curl -X POST https://cashly.corenexis.com/api/mcp \
  -H "x-api-key: cn_cashly_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Log an expense
curl -X POST https://cashly.corenexis.com/api/mcp \
  -H "x-api-key: cn_cashly_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_transaction",
      "arguments": { "type": "debit", "amount": 500, "category": "Groceries" }
    }
  }'

MCP tools

71 tools. Reads are marked read-only and deletes destructive, so clients can ask before acting.

Full list with arguments: docs/mcp.md.

REST API

Base URL https://cashly.corenexis.com/api/v1, header x-api-key: <key> (or Authorization: Bearer <key>).

curl https://cashly.corenexis.com/api/v1/transactions \
  -H "x-api-key: cn_cashly_your_key_here" \
  -H "User-Agent: my-app/1.0"

Resources: /me, /usage, /categories, /payment-methods, /stats, /transactions, /debts, /accounts, /banks, /credit-cards, /debit-cards, /wallets, /emis, /subscriptions, /upcoming-bills, /webhooks. Data resources support list, get, create, update and delete.

Details, rate limits and error codes: docs/rest-api.md. Webhooks: docs/webhooks.md.

Security and privacy

• OAuth 2.1 with PKCE and Dynamic Client Registration; access tokens last one hour.
• API keys can be read only; every request is scoped to the key owner's data.
• Keys and connected apps can be revoked any time in Settings -> Developer.
• No bank login, no SMS access, no card numbers. Data is never sold or shared with advertisers.

Links

• Website: https://cashly.corenexis.com
• Try the app without an account: https://cashly.corenexis.com/api/auth/demo
• Android: https://play.google.com/store/apps/details?id=com.corenexis.cashly
• MCP guide: https://cashly.corenexis.com/developer/mcp
• API docs: https://cashly.corenexis.com/developer/api
• Support: https://helpdesk.corenexis.com or [email protected]

Cashly is built by Corenexis. This repository holds documentation and examples; the Cashly service itself is hosted by Corenexis. Examples are released under the MIT License.