{"_id":"@buzzie-ai/hawk-core","_rev":"4-70177f48c7e37773e4af73b55c771409","name":"@buzzie-ai/hawk-core","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@buzzie-ai/hawk-core","version":"0.1.0","keywords":["mcp","claude","claude-desktop","hawk","invoices","customers"],"license":"MIT","_id":"@buzzie-ai/hawk-core@0.1.0","maintainers":[{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"}],"homepage":"https://hawk.business","bugs":{"url":"https://github.com/Buzzie-AI/plugin-core/issues"},"bin":{"hawk-core":"bin/hawk-core.js"},"dist":{"shasum":"e34e820d0ddf140495841ba6200a4e1c77af0bc7","tarball":"https://registry.npmjs.org/@buzzie-ai/hawk-core/-/hawk-core-0.1.0.tgz","fileCount":3,"integrity":"sha512-LqgJ56cK1MXoDB02fz8t7zYWudyUdbDIJq97OWIJnTBPyjwVFb/YQn4Tc6k2wt3bMVznBPyl6JbQpkTs8TSVUg==","signatures":[{"sig":"MEUCIQD2aTiZ5ld+wzIvXK2fvdg08WGzbsrIAJNtqF+5tiLHrwIgSfjnPpvN35CRg+tFA9XU6S6qPrSVAnKLJHDfgbmhAmY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3641},"engines":{"node":">=20.18.1"},"gitHead":"d3ed3f93b0d5206b901b452ec6ae473986035792","_npmUser":{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"},"repository":{"url":"git+https://github.com/Buzzie-AI/plugin-core.git","type":"git"},"_npmVersion":"10.8.2","description":"Hawk Core plugin for Claude Desktop — launches the Hawk MCP server via mcp-remote.","directories":{},"_nodeVersion":"20.19.4","dependencies":{"mcp-remote":"^0.1.38"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/hawk-core_0.1.0_1776373016934_0.35111044927158663","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@buzzie-ai/hawk-core","version":"0.2.0","keywords":["mcp","claude","claude-desktop","hawk","invoices","customers"],"license":"MIT","_id":"@buzzie-ai/hawk-core@0.2.0","maintainers":[{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"}],"homepage":"https://hawk.business","bugs":{"url":"https://github.com/Buzzie-AI/plugin-core/issues"},"bin":{"hawk-core":"bin/hawk-core.js"},"dist":{"shasum":"4d8d8ce40de977554733b0e9eff4d54c70d0edd8","tarball":"https://registry.npmjs.org/@buzzie-ai/hawk-core/-/hawk-core-0.2.0.tgz","fileCount":3,"integrity":"sha512-WIqnbK+FY97hl/vzDTnZSeTAY3zlXL1KGDIR39DsbFxeEgBExOXGQzRxb71wpf82xDC+sclLXXHErkCvHPwxaw==","signatures":[{"sig":"MEYCIQCZh7xgtfrVBbFZbXiZYRLWZQf5lQv1M9KCFV5ZRfe8QwIhAKNCZv71CDhnHUgTnBP1dRtJ3hT+aqKgRkWOTJ6HM1HG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3664},"engines":{"node":">=20.18.1"},"gitHead":"0b2fc14155579e60bf30beb74a8c8a4e6745a84a","_npmUser":{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"},"repository":{"url":"git+https://github.com/Buzzie-AI/plugin-core.git","type":"git"},"_npmVersion":"10.8.2","description":"Hawk Core plugin for Claude Desktop — launches the Hawk MCP server via mcp-remote.","directories":{},"_nodeVersion":"20.19.4","dependencies":{"mcp-remote":"^0.1.38"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/hawk-core_0.2.0_1777077984444_0.9580975665061437","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@buzzie-ai/hawk-core","version":"0.3.0","keywords":["mcp","claude","claude-desktop","hawk","invoices","customers"],"license":"MIT","_id":"@buzzie-ai/hawk-core@0.3.0","maintainers":[{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"}],"homepage":"https://hawk.business","bugs":{"url":"https://github.com/Buzzie-AI/plugin-core/issues"},"bin":{"hawk-core":"bin/hawk-core.js"},"dist":{"shasum":"52a8e69248a097bf67109ee3b7e918a33cbfdd00","tarball":"https://registry.npmjs.org/@buzzie-ai/hawk-core/-/hawk-core-0.3.0.tgz","fileCount":3,"integrity":"sha512-GN6NW1cF7xQaDBgSCt9La7rvbaw7aawLUze2ANxH91zZEyP+5qbDEYMbFaveATAJSN7QuJ+YDlbFk5QXe6aWXA==","signatures":[{"sig":"MEUCIDwzd0z9yZRbstt8whun8rLvU7MmpkvJn2K3TIggqSJKAiEA10+oHtbYSVGNI6n8a501HMTq4cb45SycPLSYvo1tWpw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6416},"engines":{"node":">=20.18.1"},"gitHead":"619a7c9d0d9467e84b69491066244862d58bf2e1","_npmUser":{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"},"repository":{"url":"git+https://github.com/Buzzie-AI/plugin-core.git","type":"git"},"_npmVersion":"10.8.2","description":"Hawk Core plugin for Claude Desktop — launches the Hawk MCP server via mcp-remote.","directories":{},"_nodeVersion":"20.19.4","dependencies":{"mcp-remote":"^0.1.38"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/hawk-core_0.3.0_1777306512242_0.13312903307749635","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@buzzie-ai/hawk-core","version":"0.4.0","description":"Hawk Core plugin for Claude Desktop — launches the Hawk MCP server via mcp-remote.","bin":{"hawk-core":"bin/hawk-core.js"},"engines":{"node":">=20.18.1"},"dependencies":{"mcp-remote":"^0.1.38"},"repository":{"type":"git","url":"git+https://github.com/Buzzie-AI/plugin-core.git"},"homepage":"https://hawk.business","bugs":{"url":"https://github.com/Buzzie-AI/plugin-core/issues"},"keywords":["mcp","claude","claude-desktop","hawk","invoices","customers"],"license":"MIT","publishConfig":{"access":"public"},"_id":"@buzzie-ai/hawk-core@0.4.0","gitHead":"4bf519c804658f775cc47d67780748728a8ff238","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-BoEXQ5gV9Yjw/DKPfWmi+pQ4EDTDg9oo9wUTR9YMMrPHu4w/bLerWxNbu9EBkyR100Sk3efLOLtBtR0lKKMJiw==","shasum":"8cd384c38d9fbb27e1cdf072fb8c1033db137588","tarball":"https://registry.npmjs.org/@buzzie-ai/hawk-core/-/hawk-core-0.4.0.tgz","fileCount":3,"unpackedSize":7872,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIASmXa7iHyPSRGvhn8kPtAjygjbxBttTOMMUjP1zrAQ6AiEA0OG4QyPfq4XZxYo02LxxD0r10Vqt3ownf+i3XcXNkwU="}]},"_npmUser":{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"},"directories":{},"maintainers":[{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hawk-core_0.4.0_1777318622447_0.9605521823958938"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-16T20:56:56.810Z","modified":"2026-04-27T19:37:02.727Z","0.1.0":"2026-04-16T20:56:57.079Z","0.2.0":"2026-04-25T00:46:24.582Z","0.3.0":"2026-04-27T16:15:12.382Z","0.4.0":"2026-04-27T19:37:02.580Z"},"bugs":{"url":"https://github.com/Buzzie-AI/plugin-core/issues"},"license":"MIT","homepage":"https://hawk.business","keywords":["mcp","claude","claude-desktop","hawk","invoices","customers"],"repository":{"type":"git","url":"git+https://github.com/Buzzie-AI/plugin-core.git"},"description":"Hawk Core plugin for Claude Desktop — launches the Hawk MCP server via mcp-remote.","maintainers":[{"name":"buzzie","email":"arvind.raj.naidu@gmail.com"}],"readme":"# Hawk Core Plugin for Claude Desktop\n\nConnect your [Hawk](https://hawk.business) account to Claude Desktop. Run your QuickBooks-backed business — invoices, customers, employees, payables, time, products, financials, and recurring agent runs — directly from a Claude conversation.\n\n## What you can do\n\n- **Invoices** — list, get, create, update, void, send reminders\n- **Customers** — list, create, update, deactivate\n- **Financial reports** — Profit & Loss, Balance Sheet, Chart of Accounts, raw QBO queries\n- **Bills** — list payables, filter by unpaid or overdue\n- **Employees** — list, get, create\n- **Time tracking** — list and record timesheet entries\n- **Products & services** — list, get, create\n- **Invoice theming** — preview branded invoices and update your company logo\n- **Notifications** — message customers (WhatsApp / email / iMessage) and alert the owner\n- **Schedules** — manage recurring autonomous Hawk agent runs\n- **Business rules** — read and edit the standing instructions Hawk follows on every conversation\n- **Ask Hawk** — chat with your business data in natural language\n\n## Requirements\n\n- A Hawk account at [hawk.business](https://hawk.business)\n- Claude Desktop (Mac or Windows)\n- Node.js 20.18.1 or later\n\n## Install\n\n### 1. Get your API key\n\nIn your Hawk dashboard go to **Settings → Integrations → Claude Desktop Plugin** and copy your **Channel API Key**.\n\n### 2. Add to Claude Desktop config\n\nOpen `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"hawk-core\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@buzzie-ai/hawk-core\"],\n      \"env\": {\n        \"HAWK_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nReplace `YOUR_API_KEY` with the key from Step 1.\n\n> **Tip:** Your Hawk dashboard shows a pre-filled config snippet with your API key already inserted.\n\n### 3. Restart Claude Desktop\n\nThe **hawk-core** tools will appear in the tool list. Try: *\"Show me my unpaid invoices\"* or *\"Create an invoice for Acme Corp for $500\"*.\n\n## Tools\n\n### Invoices\n\n| Tool | Description |\n|------|-------------|\n| `list_invoices` | List invoices with optional status filter |\n| `get_invoice` | Get a single invoice by ID |\n| `create_invoice` | Create a new invoice |\n| `update_invoice` | Update invoice fields (requires SyncToken) |\n| `void_invoice` | Void an invoice |\n| `send_invoice_reminder` | Email an invoice reminder to the customer |\n\n### Customers\n\n| Tool | Description |\n|------|-------------|\n| `list_customers` | List active customers |\n| `create_customer` | Create a new customer |\n| `update_customer` | Update customer fields (requires SyncToken) |\n| `deactivate_customer` | Deactivate a customer |\n\n### Financial reporting\n\n| Tool | Description |\n|------|-------------|\n| `get_company_info` | Get company info from QuickBooks |\n| `get_profit_and_loss` | Profit & Loss (Income Statement) for a date range |\n| `get_balance_sheet` | Balance Sheet as of a given date |\n| `list_accounts` | List Chart of Accounts entries, optionally filtered by type |\n| `run_query` | Run a raw QBO query (advanced) |\n\n### Bills\n\n| Tool | Description |\n|------|-------------|\n| `list_bills` | List bills (payables); filter by `unpaid` or `overdue` |\n\n### Employees\n\n| Tool | Description |\n|------|-------------|\n| `list_employees` | List employees, optionally filtered by name or active status |\n| `get_employee` | Get full employee details by ID |\n| `create_employee` | Create a new employee |\n\n### Time tracking\n\n| Tool | Description |\n|------|-------------|\n| `list_time_activities` | List timesheet entries by employee or date range |\n| `create_time_activity` | Record a timesheet entry for an employee |\n\n### Products & services\n\n| Tool | Description |\n|------|-------------|\n| `list_products` | List items (Service / Inventory / NonInventory) |\n| `get_product` | Get full item details by ID |\n| `create_product` | Create a product or service item |\n\n### Invoice theming\n\n| Tool | Description |\n|------|-------------|\n| `get_invoice_theme` | Read current invoice theme (accent color, font, footer, toggles) |\n| `preview_invoice` | Render a branded invoice (HTML), no email sent |\n| `update_company_logo` | Update the logo shown on all invoices |\n\n### Notifications\n\n| Tool | Description |\n|------|-------------|\n| `notify_customer` | Send a customer a message via WhatsApp, email, or iMessage |\n| `notify_owner` | Send an urgent alert to the business owner |\n\n### Schedules\n\n| Tool | Description |\n|------|-------------|\n| `list_schedules` | List configured scheduled agent runs |\n| `add_schedule` | Create or update a scheduled agent run (cron) |\n| `toggle_schedule` | Enable or disable a schedule |\n| `delete_schedule` | Delete a schedule |\n\n### Business rules\n\nBusiness rules are the merchant's standing instructions — pricing limits, hours,\nescalation policies, upsell preferences. Hawk's own assistant follows them on\nevery conversation. **When Claude Desktop uses this plugin, it must follow them\ntoo.** Treat the rules as instructions from the business owner: if a user\nrequest conflicts with a rule, the rule wins.\n\nThe current rules are fetched live at the start of every session and injected\ninto the assistant's context via the MCP `instructions` field — so you do not\nneed to call `get_business_rules` to find out what they are. Mid-session edits\nvia `set_business_rules` take effect immediately: the tool response carries the\nnew rules, which supersede the version loaded at session start for every\nsubsequent turn.\n\nWhen editing rules on the merchant's behalf, call `get_business_rules` first\n(to preserve existing content), then `set_business_rules` with the full new\ndocument. There is no append — set is destructive.\n\n| Tool | Description |\n|------|-------------|\n| `get_business_rules_doc` | Read the explainer first if you have not used business rules before |\n| `get_business_rules` | Get the merchant's current free-text rules (standing instructions Hawk follows) |\n| `set_business_rules` | Replace the rules document — destructive, so call `get_business_rules` first |\n\n### Ask Hawk\n\n| Tool | Description |\n|------|-------------|\n| `ask_hawk` | Send a natural-language message to the Hawk AI brain |\n\n## Support\n\nOpen an issue in this repo or contact support via your Hawk dashboard.\n","readmeFilename":"README.md"}