Cashly API и MCP Server

Приложение для учёта расходов, EMI и долгов с REST API и удалённым MCP-сервером.

Позвольте ChatGPT, Claude, n8n или собственному AI-агенту просматривать и записывать ваши финансовые операции в любой валюте.

Сайт · Руководство по MCP · Документация API · Google Play · Реестр MCP

Что такое Cashly?

Cashly — бесплатное приложение для Android и веба, которое помогает вести личные финансы. Им пользуются по всему миру, в разных валютах и часовых поясах. Приложение отслеживает расходы и доходы, фактические остатки на банковских счетах, картах и в кошельках, EMI и кредиты, одолженные и занятые деньги, а также счета с приближающимся сроком оплаты. Cashly никогда не запрашивает данные для входа в банк, не читает SMS и не показывает рекламу.

В этом репозитории собраны общедоступные инструменты Cashly для разработчиков:


MCP-сервер	`https://cashly.corenexis.com/api/mcp` — удалённый сервер с поддержкой Streamable HTTP, OAuth 2.1 или API key
REST API	`https://cashly.corenexis.com/api/v1` — формат JSON, заголовок `x-api-key`
Webhooks	Подписанные уведомления о каждом создании, изменении и удалении
n8n	Узел сообщества `@corenexis/n8n-nodes-cashly`
Имя в реестре	`com.corenexis/cashly` в официальном реестре MCP

Сервер размещён на стороне Corenexis. Устанавливать и запускать ничего не нужно — достаточно указать URL в клиенте.

Что можно делать с помощью Cashly

Можно задавать ассистенту, например, такие запросы:

«Добавь сегодняшние расходы на продукты — 450, оплата через UPI».
«Сколько я потратил на еду в этом месяце по сравнению с прошлым?»
«Какие счета нужно оплатить в ближайшие 7 дней?»
«Отметь EMI по автокредиту за этот месяц как оплаченную».
«Кто должен мне деньги и сколько осталось по каждому долгу?»
«Создай кредитную карту Travel Card с лимитом 2,00,000».

Все действия выполняются только с данными вошедшего в систему пользователя. Реальные деньги не перемещаются: запись об оплате лишь обновляет данные в трекере.

Быстрый старт

1. Получите доступ

ChatGPT и другие клиенты с поддержкой OAuth: ключ не нужен. Войдите в Cashly и подтвердите доступ.
Все остальные клиенты: создайте API key в Cashly: Settings -> Developer -> API keys. Ключи имеют формат cn_cashly_... и могут предоставлять доступ только для чтения или для чтения и записи. Для одной учётной записи можно создать до 5 ключей.

Доступ к API, MCP и webhook входит в планы Cashly Pro и Pro Plus.

2. Подключите клиент

ChatGPT (OAuth, без ключа)

В ChatGPT откройте Settings -> Apps (Connectors) -> Advanced и включите Developer mode.
Нажмите Create app (добавьте собственный MCP-сервер):
- Name: Cashly
- Server URL: https://cashly.corenexis.com/api/mcp
- Authentication: OAuth (оставьте поля client ID и secret пустыми — ChatGPT зарегистрируется самостоятельно)
Нажмите Connect, войдите в Cashly и нажмите Allow. Если ChatGPT должен только просматривать данные, отметьте Read only.

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

Добавьте эту конфигурацию в claude_desktop_config.json (см. 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 и другие MCP-клиенты

Любой клиент с поддержкой удалённых серверов Streamable HTTP можно подключить с помощью такой конфигурации:

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

n8n

Рабочие процессы: установите узел сообщества @corenexis/n8n-nodes-cashly (Settings -> Community nodes).

В нём доступны все действия Cashly и триггер мгновенного webhook.

AI Agent: добавьте узел MCP Client (или инструмент MCP Client в узле AI Agent), выберите тип транспорта HTTP Streamable, укажите адрес https://cashly.corenexis.com/api/mcp и передайте ключ в заголовке x-api-key.

curl / любой HTTP-клиент

# 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

Доступен 71 инструмент. Операции чтения помечены как доступные только для чтения, а удаление — как необратимое действие. Поэтому клиент может запросить подтверждение перед выполнением таких операций.

Раздел	Инструменты
Учётная запись	`get_profile`, `health_check`, `get_rate_limit_status`, `get_usage`, `get_user`, `update_user`, `get_billing_status`, `get_billing_payments`, `list_signed_in_devices`, `list_connected_apps`, `update_notifications`
Справочники и статистика	`get_categories`, `get_payment_methods`, `get_stats`
Транзакции	`list_transactions`, `get_transaction`, `create_transaction`, `update_transaction`, `delete_transaction`
Долги (одолженные и занятые деньги)	`list_debts`, `get_debt`, `create_debt`, `update_debt`, `delete_debt`, `record_debt_payment`, `settle_debt`, `add_to_debt`, `unsettle_debt`
Счета	`list_accounts`, а также операции получения списка, создания, изменения и удаления банковских счетов, кредитных карт, дебетовых карт и кошельков
EMI и кредиты	`list_emis`, `get_emi`, `get_emi_payments`, `create_emi`, `update_emi`, `delete_emi`, `record_emi_payment`
Подписки	`list_subscriptions`, `get_subscription`, `get_subscription_payments`, `create_subscription`, `update_subscription`, `delete_subscription`, `record_subscription_payment`
Предстоящие счета	`get_upcoming_bills`, `record_bill_payment`, `skip_upcoming_bill`
Webhooks	`list_webhook_events`, `list_webhooks`, `get_webhook`, `create_webhook`, `update_webhook`, `rotate_webhook_secret`, `delete_webhook`, `send_webhook_test`, `list_webhook_deliveries`

Полный список инструментов с аргументами: docs/mcp.md.

REST API

Базовый URL: https://cashly.corenexis.com/api/v1. Используйте заголовок x-api-key: или Authorization: Bearer .

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

Ресурсы: /me, /usage, /categories, /payment-methods, /stats, /transactions, /debts,

/accounts, /banks, /credit-cards, /debit-cards, /wallets, /emis, /subscriptions,

/upcoming-bills, /webhooks. Для ресурсов с данными доступны операции получения списка, чтения, создания, изменения и удаления.

Подробнее о возможностях, ограничениях запросов и кодах ошибок: docs/rest-api.md. Информация о webhooks: docs/webhooks.md.

Безопасность и конфиденциальность

Используется OAuth 2.1 с PKCE и Dynamic Client Registration; срок действия токенов доступа — один час.
API keys могут предоставлять доступ только для чтения; каждый запрос ограничен данными владельца ключа.
Ключи и подключённые приложения можно в любой момент отозвать в разделе Settings -> Developer.
Cashly не запрашивает данные для входа в банк и доступ к SMS, а также не хранит номера карт. Данные никогда не продаются и не передаются рекламодателям.

Ссылки

Сайт: https://cashly.corenexis.com
Попробуйте приложение без учётной записи: https://cashly.corenexis.com/api/auth/demo
Android: https://play.google.com/store/apps/details?id=com.corenexis.cashly
Руководство по MCP: https://cashly.corenexis.com/developer/mcp
Документация API: https://cashly.corenexis.com/developer/api
Поддержка: https://helpdesk.corenexis.com или support@corenexis.com

Cashly создан компанией Corenexis. В этом репозитории размещены документация и примеры; сам сервис Cashly размещён на стороне Corenexis. Примеры распространяются по лицензии MIT License.