longbook
Your longbook of bills, subscriptions and expenses, for your AI to read and to suggest changes to.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http longbook 'https://longbook.app/mcp'
{
"mcpServers": {
"longbook": {
"type": "http",
"url": "https://longbook.app/mcp"
}
}
}
@longbook/mcpclaude mcp add longbook -- npx -y @longbook/mcp@1.40.4 --vault
{
"mcpServers": {
"longbook": {
"command": "npx",
"args": [
"-y",
"@longbook/mcp@1.40.4",
"--vault"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
longbook
A financial memory for your AI. longbook keeps your recurring money — subscriptions, insurance, EMIs, school fees, domains, renewals — as a meticulous, machine-readable memory that the AI you already use can read, fill, and build on. Your AI gathers from your statements and emails; longbook remembers, checks, and shows you every change for approval.
- Native apps for iPhone and Mac (SwiftUI), one $38 purchase with a 7-day refund, one purchase unlocks every platform; longbook Cloud, $4 a month, covers what uses the server.
- Your data is a folder of plain files you own — self-describing (
llms.txt+ a JSON Schema), synced through your own iCloud Drive. - Designed so it cannot hold secrets: no card numbers, no CVVs, no credentials — the schema and validators refuse them, which is what makes everything else safe.
- Connects to your AI over MCP — locally for desktop AI apps, hosted for ChatGPT and phones.
Site: longbook.app · Contact: contact@longbook.app
Status
The domain engine (packages/core), the Swift data layer (packages/swift-core), the
accounts and entitlements backend (supabase/) and the native app (apps/longbook) are
all in place; the app runs on both platforms and ships through App Store Connect. Docs
describe what exists today.
Layout
| Path | What it is |
|---|---|
packages/core | The domain engine — dates, money, selectors, insights, the data-policy scanner; pure TypeScript, no runtime deps |
packages/swift-core | The same data layer in Swift, as a multiplatform package (iOS 17+, macOS 14+) shared by both app targets |
packages/swift-design | The design system — colour, type, spacing, and the SwiftUI pieces both apps draw with |
packages/mcp | The MCP server — the memory's read and write tools over stdio for the AI on the owner's machine, and the engine behind the hosted twin at longbook.app/mcp, which reads the pushed copy and takes writes as proposals |
packages/cards | Self-contained HTML cards over the same numbers — the design system's tokens, exported once, feeding a second renderer |
supabase/ | Accounts, trial clock, entitlements, purchases, the hosted MCP and hosted copy, statement reading, report sharing |
apps/longbook | The native SwiftUI app — one target building for iOS and macOS, with the Home Screen widget |
apps/longbook-site | The static site at longbook.app — the pages, the guide and schema at stable addresses, and the edge functions behind /mcp and shared reports |
docs/ | Architecture · Vault format · Agentic tools · Building · Contributing |
License
GPL-3.0. Copyright © 2026 Rohit Kundliwal. Contributions are accepted under the licence grant in contributing. The longbook name and mark identify this project's own releases.
الأسئلة الشائعة
ما هو longbook؟
Your longbook of bills, subscriptions and expenses, for your AI to read and to suggest changes to.
كيف أثبّت longbook؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http longbook 'https://longbook.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج longbook إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل longbook مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.
من يصون longbook؟
ينشره MXmaster2s. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.