{"_id":"@codespar/mcp-xero","_rev":"5-a298347df5a6575e24d0d00957197e2c","name":"@codespar/mcp-xero","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-xero","version":"0.1.0","keywords":["mcp","xero","accounting","erp","invoicing","bookkeeping","smb","uk","australia","new-zealand","global"],"license":"MIT","_id":"@codespar/mcp-xero@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-xero":"dist/index.js"},"dist":{"shasum":"c83ff7bd2ee3decdd9e41fe94854f16e2d8aa325","tarball":"https://registry.npmjs.org/@codespar/mcp-xero/-/mcp-xero-0.1.0.tgz","fileCount":6,"integrity":"sha512-UfdiohX94roqm//Uj72FCnKNM+b0mLZTdvStLvrKSLBlbu6bM6xeuw/6nbl2rPhWbKq07S48/QozHiReTlUtQw==","signatures":[{"sig":"MEYCIQD0cx9op18D4p6lfI69t8f+uaELrEPwSX1GMW+siWl+NAIhAI8STZ1POtfe/58Jxc8pDxTlI92Emia59DCsgmLeKrKy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49450},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8f8994b2acdc8be3a6c666b30ef44974f33752ed","mcpName":"io.github.codespar/mcp-xero","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Xero — global cloud accounting (UK/AU/NZ leader, expanding in US). Contacts, invoices, payments, items, accounts, reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xero_0.1.0_1776997185666_0.3482233073145833","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-xero","version":"0.2.0","keywords":["mcp","xero","accounting","erp","invoicing","bookkeeping","smb","uk","australia","new-zealand","global"],"license":"MIT","_id":"@codespar/mcp-xero@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-xero":"dist/index.js"},"dist":{"shasum":"35943e2ae104c33d77f0af0ce9f2463f374fd546","tarball":"https://registry.npmjs.org/@codespar/mcp-xero/-/mcp-xero-0.2.0.tgz","fileCount":6,"integrity":"sha512-QXzEXn5kShf+wLrDu9eeICy6JhMs1yk3YfMdGEvQ5R3lIxMP31FEJZiczHKmIQedriVe+vc+pFmmaWROrQ/PvA==","signatures":[{"sig":"MEYCIQCA65a/rEKvSwoZe8knUkbKqGCpWDfiwdH6t2Ogzl3acQIhAKszLM7qJcH26VMYae2/aDMXi+lZxYCk65pJRq9NTf5I","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":77574},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ea10b1dfe82e3d4b5e84fffdfe18d44018529bfa","mcpName":"io.github.codespar/mcp-xero","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Xero — global cloud accounting (UK/AU/NZ leader, expanding in US). Contacts, invoices, payments, items, accounts, reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xero_0.2.0_1777064141885_0.5055644297098969","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-xero","version":"0.2.1","keywords":["mcp","xero","accounting","erp","invoicing","bookkeeping","smb","uk","australia","new-zealand","global"],"license":"MIT","_id":"@codespar/mcp-xero@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-xero":"dist/index.js"},"dist":{"shasum":"50d7d98f2f97a493688fd4443c24f61762493c1c","tarball":"https://registry.npmjs.org/@codespar/mcp-xero/-/mcp-xero-0.2.1.tgz","fileCount":6,"integrity":"sha512-LK+s/TzZoiJucVcxJOZIpoLv2VB7NaWN+34VDiyOpHF1nREUAZ4YKqL+p1jknN/hUanFhvXf+kY6gkWsE1FP8Q==","signatures":[{"sig":"MEUCIQDf0LQofU8NIYNwaVkgLwu9LoblrA2XS422MGBi52clAQIgZAFBpgqNm/mvVG4PxoG3CosXcZyAnbTvZWnGhXGDrhk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78690},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-xero","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Xero — global cloud accounting (UK/AU/NZ leader, expanding in US). Contacts, invoices, payments, items, accounts, reports.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xero_0.2.1_1777123075823_0.9138143707039268","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-xero","version":"0.2.2","description":"MCP server for Xero — global cloud accounting (UK/AU/NZ leader, expanding in US). Contacts, invoices, payments, items, accounts, reports.","type":"module","main":"./dist/index.js","bin":{"mcp-xero":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","xero","accounting","erp","invoicing","bookkeeping","smb","uk","australia","new-zealand","global"],"mcpName":"io.github.codespar/mcp-xero","_id":"@codespar/mcp-xero@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-FxHJJ/3JskWs7Rg2Jx5AMswi9m1gs0Oo8XH8MGjK1VUrrdRm2sBS3HuoWOykOsa6ElvvYKEkt750Eg0bcqe1tA==","shasum":"5a593264f2d8da4e1dabff4a7ede137ae425c899","tarball":"https://registry.npmjs.org/@codespar/mcp-xero/-/mcp-xero-0.2.2.tgz","fileCount":6,"unpackedSize":80133,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBbCHFGcJDJX3RFuRmv8S+uqC+Wt081ejntltSfDNm5dAiAKj45heFi8a+dEEER7Aq2/g711JlCRDiO4MIKuOuuQow=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-xero_0.2.2_1782153626124_0.7768250278121349"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T02:19:45.568Z","modified":"2026-06-22T18:40:26.441Z","0.1.0":"2026-04-24T02:19:45.832Z","0.2.0":"2026-04-24T20:55:42.050Z","0.2.1":"2026-04-25T13:17:55.966Z","0.2.2":"2026-06-22T18:40:26.278Z"},"license":"MIT","keywords":["mcp","xero","accounting","erp","invoicing","bookkeeping","smb","uk","australia","new-zealand","global"],"description":"MCP server for Xero — global cloud accounting (UK/AU/NZ leader, expanding in US). Contacts, invoices, payments, items, accounts, reports.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-xero\n\nMCP server for [Xero](https://www.xero.com) — global cloud accounting for SMBs.\n\nXero is the #2 global SMB ERP and the leader in the UK, Australia, and New Zealand, with rapid expansion in the US. Paired with QuickBooks, the two platforms cover roughly 80% of global SMB accounting. For LatAm SaaS serving US/UK/AU/NZ customers or with international subsidiaries, Xero is the essential complement to our Brazil-native ERPs (Omie, Conta Azul, Bling, Tiny).\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `create_contact` | Create a Xero contact (customer or supplier — Xero uses one unified Contact object with IsCustomer/IsSuppli... |\n| `get_contact` | Retrieve a single Xero contact by ContactID (UUID). |\n| `list_contacts` | List Xero contacts. |\n| `create_invoice` | Create an invoice in Xero. |\n| `get_invoice` | Retrieve a single invoice by InvoiceID (UUID) or InvoiceNumber. |\n| `list_invoices` | List invoices with optional Xero where-clause filtering. |\n| `email_invoice` | Email an AUTHORISED invoice to the contact's email address on file. |\n| `create_payment` | Record a payment against an invoice or credit note. |\n| `create_item` | Create a Xero inventory/product item. |\n| `list_items` | List all items/products in the Xero tenant. |\n| `list_accounts` | List the Xero chart of accounts. |\n| `update_contact` | Update an existing Xero contact. |\n| `archive_contact` | Archive a Xero contact by setting ContactStatus=ARCHIVED. |\n| `update_invoice` | Update an existing invoice. |\n| `void_invoice` | Void an invoice by setting Status=VOIDED. |\n| `get_payment` | Retrieve a single payment by PaymentID. |\n| `list_payments` | List payments recorded in Xero. |\n| `create_bank_transaction` | Create a bank transaction (SPEND = money out, RECEIVE = money in) directly on a bank account — for transact... |\n| `list_bank_transactions` | List bank transactions (spend/receive entries on bank accounts). |\n| `list_organisations` | Retrieve the Xero organisation(s) the access token has access to — returns name, base currency, country, fi... |\n| `list_tax_rates` | List tax rates configured in the Xero tenant. |\n| `create_credit_note` | Create a credit note. |\n| `list_credit_notes` | List credit notes. |\n| `get_balance_sheet` | Retrieve the Balance Sheet report for the tenant. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-xero\n```\n\n## Environment\n\n```bash\nXERO_ACCESS_TOKEN=\"...\"   # OAuth2 bearer access token (required, secret)\nXERO_TENANT_ID=\"...\"      # Xero tenant/organization id (required)\n```\n\n## Authentication\n\nXero uses OAuth2. Every request includes:\n\n```\nAuthorization: Bearer <XERO_ACCESS_TOKEN>\nXero-tenant-id: <XERO_TENANT_ID>\nAccept: application/json\nContent-Type: application/json\n```\n\nThis server assumes a **pre-issued access token**. OAuth consent, refresh-token rotation, and tenant selection happen upstream (in your OAuth proxy or secrets layer). When the token expires, Xero returns 401 and the tool surfaces the error verbatim — refresh and retry.\n\n## Run\n\n```bash\n# stdio (default — Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-xero\n\n# HTTP (server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-xero\n```\n\n## Where clause\n\nXero's list endpoints accept a `where` query param for server-side filtering. Examples:\n\n```\nName.Contains(\"ACME\")\nIsCustomer==true\nStatus==\"AUTHORISED\" AND Type==\"ACCREC\"\nDate>=DateTime(2026,1,1)\nContact.ContactID==guid(\"00000000-0000-0000-0000-000000000000\")\n```\n\n## Positioning in the CodeSpar ERP catalog\n\n- **Brazil-native:** Omie, Conta Azul, Bling, Tiny — NF-e, Simples Nacional, local tax.\n- **Global SMB:** **Xero** + QuickBooks — US/UK/AU/NZ/global accounting.\n\nUse Xero for companies headquartered or operating outside Brazil (or with international entities). Use the BR-native servers for the local market.\n\n## Docs\n\n- Xero Accounting API: https://developer.xero.com/documentation/api/accounting\n- Xero OAuth2 guide: https://developer.xero.com/documentation/guides/oauth2/overview\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}