English Français العربية

Booksmate

السجل الرسمي البحث والويب

Search, summarise and export your invoices and receipts collected from email and supplier portals.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Booksmate؟

  • Show my invoices from last month.
  • What did I spend on software this quarter, broken down by vendor?
  • Find any duplicate payments over 500 in the last 90 days.
  • Upload this receipt PDF and pull out the vendor and total.
  • Import my latest receipts from Gmail.
  • Export everything unexported to Xero.
  • Zip up my Q1 invoices and give me a download link for my accountant.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http booksmate 'https://mcp.booksmate.com'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "booksmate": {
            "type": "http",
            "url": "https://mcp.booksmate.com"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Booksmate
  2. Install
  3. Sign in
  4. What you can ask for
  5. Skills
  6. Docs
  7. About this repository
  8. License

Booksmate

Fetch invoices and receipts from email and supplier portals, then work them in chat.

Booksmate pulls documents from connected Gmail and Microsoft mailboxes, and from supplier web portals via the Booksmate desktop app. It extracts fields with AI and exports to Xero or Google Drive. This plugin connects an agent to your account through the hosted MCP server at mcp.booksmate.com. Email ingestion runs here. Web portal fetching stays on the desktop app. Ask for last month's Amazon invoices and you get the real rows out of your account, not a guess.

Install

Cursor

Open the Cursor Marketplace and search for "Booksmate", then click install. You can also open Customize and search there.

The plugin ships an mcp.json pointing at the hosted server. Cursor picks it up automatically. There is nothing to configure.

Grok Bot

Add the server URL https://mcp.booksmate.com as an MCP connector. The skills in this repo are plain skills/*/SKILL.md files, so any agent that reads skill directories can use them alongside the connector.

Claude Code

Clone https://github.com/odwyersoftware/booksmate-plugins and start Claude Code with claude --plugin-dir booksmate-plugins/claude.

That flag loads the claude/ directory for the session. It ships a .mcp.json pointing at the hosted server over streamable HTTP. The server entry sets "type": "http", which Claude Code requires on a URL. There is nothing else to configure.

Any other MCP client

Point the client at https://mcp.booksmate.com. The transport is streamable HTTP.

Sign in

There is no API key. Authentication is OAuth 2.1 with dynamic client registration, so the first tool call opens a browser for consent. Approve it once and the client holds the token from then on. If you have no Booksmate account yet, sign up at booksmate.com first.

Revoke access any time from your Booksmate account settings.

What you can ask for

  • Show my invoices from last month.
  • What did I spend on software this quarter, broken down by vendor?
  • Find any duplicate payments over 500 in the last 90 days.
  • Upload this receipt PDF and pull out the vendor and total.
  • Import my latest receipts from Gmail.
  • Export everything unexported to Xero.
  • Zip up my Q1 invoices and give me a download link for my accountant.

Skills

Seven skills teach the agent how to drive the tools well.

SkillWhat it covers
document-searchFind and inspect invoices and receipts by vendor, date, amount, or status
spend-analysisTotals and trends by category, vendor, month, or document type
upload-extractUpload PDFs, images, and office files for AI extraction
duplicate-detectionCatch double payments by comparing vendor, amount, and currency
email-ingestionPull documents from connected Gmail and Microsoft mailboxes
export-workflowSend documents to Xero or Google Drive
document-packagingBundle documents into a ZIP with a signed download link

Docs

Full documentation lives at booksmate.com/docs/features/mcp-server/.

About this repository

This repository is a build artifact. Its contents are generated from the Booksmate source repository and pushed here by CI. Direct edits to .cursor-plugin/, mcp.json, skills/, assets/, grok/, claude/, and this README get overwritten on the next sync. File issues and suggestions at booksmate.com or email richard@booksmate.com.

License

MIT.

الأسئلة الشائعة

ما هو Booksmate؟

Search, summarise and export your invoices and receipts collected from email and supplier portals.

كيف أثبّت Booksmate؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http booksmate 'https://mcp.booksmate.com'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Booksmate إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Booksmate مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Booksmate؟

ينشره odwyersoftware. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.