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

ChatGPT (OAuth, no key)

1. ChatGPT -> Settings -> Apps (Connectors) -> Advanced, turn on Developer mode.
2. Create app (add a custom MCP server):
   • Name: Cashly
   • Server URL: https://cashly.corenexis.com/api/mcp
   • Authentication: OAuth (leave client ID and secret empty - ChatGPT registers itself)
3. Press Connect, sign in to Cashly and press Allow. Tick Read only if ChatGPT should only look.

Claude Code

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

Claude Desktop

Add this to claude_desktop_config.json (see examples/claude_desktop_config.json):

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

Cursor, VS Code and other MCP clients

Any client that supports remote Streamable HTTP servers can connect with:

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

n8n

• Workflows: install the community node @corenexis/n8n-nodes-cashly (Settings -> Community nodes). It has every Cashly action plus an instant webhook trigger.
• AI Agent: add an MCP Client node (or the MCP Client Tool inside an AI Agent node), transport HTTP Streamable, endpoint https://cashly.corenexis.com/api/mcp, header x-api-key with your key.

curl / any HTTP client

# 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 support@corenexis.com

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.