Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Xero third-party MCP plugin

Cursor Agent230ae034275c
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 3b14733c..a347b9d3 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -312,6 +312,11 @@
"name": "activecampaign",
"source": "third_party/activecampaign",
"description": "Manage contacts, campaigns, automations, and deals."
+ },
+ {
+ "name": "xero",
+ "source": "third_party/xero",
+ "description": "Read and write invoices, contacts, reports, and payroll."
}
]
}
diff --git a/README.md b/README.md
index 4523c637..92802c0c 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `similarweb` | [Similarweb](third_party/similarweb/) | Cursor | Integrations | Analyze website traffic, audiences, and competitors. |
| `zoho` | [Zoho](third_party/zoho/) | Cursor | Integrations | Run tools across CRM, Desk, Books, Projects, and more. |
| `activecampaign` | [ActiveCampaign](third_party/activecampaign/) | Cursor | Integrations | Manage contacts, campaigns, automations, and deals. |
+| `xero` | [Xero](third_party/xero/) | Cursor | Integrations | Read and write invoices, contacts, reports, and payroll. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/xero/.cursor-plugin/plugin.json b/third_party/xero/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..34a3a26d
--- /dev/null
+++ b/third_party/xero/.cursor-plugin/plugin.json
@@ -0,0 +1,53 @@
+{
+ "name": "xero",
+ "displayName": "Xero",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Read and write invoices, contacts, reports, and payroll.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://github.com/XeroAPI/xero-mcp-server",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "xero",
+ "accounting",
+ "invoices",
+ "payroll",
+ "bookkeeping",
+ "finance",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "xero",
+ "accounting",
+ "mcp",
+ "finance"
+ ],
+ "variables": {
+ "type": "object",
+ "properties": {
+ "XERO_CLIENT_ID": {
+ "type": "string",
+ "title": "Xero client ID",
+ "description": "Client ID of the Custom Connection you created at developer.xero.com. A Custom Connection is bound to a single Xero organisation."
+ },
+ "XERO_CLIENT_SECRET": {
+ "type": "string",
+ "title": "Xero client secret",
+ "description": "Client secret generated alongside the Custom Connection's client ID at developer.xero.com."
+ }
+ },
+ "required": [
+ "XERO_CLIENT_ID",
+ "XERO_CLIENT_SECRET"
+ ]
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/xero/CHANGELOG.md b/third_party/xero/CHANGELOG.md
new file mode 100644
index 00000000..f94288d7
--- /dev/null
+++ b/third_party/xero/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `xero` MCP server, running `@xeroapi/xero-mcp-server` locally over stdio.
+- Auth uses a Xero Custom Connection client ID and secret supplied by the user.
+- Logo: Xero's official mark, from the `XeroAPI` GitHub organization.
diff --git a/third_party/xero/LICENSE b/third_party/xero/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/xero/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/xero/README.md b/third_party/xero/README.md
new file mode 100644
index 00000000..3e2ea49b
--- /dev/null
+++ b/third_party/xero/README.md
@@ -0,0 +1,79 @@
+# Xero
+
+Cursor plugin that connects agents to [Xero](https://www.xero.com) through Xero's official [Model Context Protocol](https://modelcontextprotocol.io/) server, run locally by Cursor.
+
+Read and write a Xero organisation's accounting and payroll data — invoices, contacts, chart of accounts, payments, quotes, journals, reports, and timesheets.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Xero**.
+3. Click **Install**, then set the Xero client ID and client secret (below).
+
+Or run `/add-plugin xero` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "xero": {
+ "type": "stdio",
+ "command": "npx",
+ "args": [
+ "-y",
+ "@xeroapi/xero-mcp-server@latest"
+ ],
+ "env": {
+ "XERO_CLIENT_ID": "${XERO_CLIENT_ID}",
+ "XERO_CLIENT_SECRET": "${XERO_CLIENT_SECRET}"
+ }
+ }
+ }
+}
+```
+
+Xero does not publish a hosted MCP endpoint. Its official server runs locally over stdio and authenticates with a **Custom Connection** — Xero's machine-to-machine OAuth 2.0 flow — so the plugin takes a client ID and secret rather than prompting for browser sign-in.
+
+## Before you connect
+
+1. Sign in at [developer.xero.com](https://developer.xero.com) and create an app with the **Custom Connection** option.
+2. Select the scopes up front. Connections created before 2026-04-29 use the bundled scope list; newer ones use the granular list. The server tries the bundled set first and falls back, so you usually do not need to set `XERO_SCOPES`.
+3. Authorize the connection from the email Xero sends, and pick the organisation to connect.
+4. Copy the **Client ID**, generate a **Client Secret**, and set both in **Dashboard → Plugins → Configure**.
+
+A Custom Connection is bound to a single Xero organisation and is a paid add-on per organisation. Payroll tools require an NZ or UK organisation.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Accounts & contacts | Chart of accounts, contacts, and contact groups |
+| Sales & purchases | Invoices, quotes, credit notes, and payments |
+| Banking | Bank transactions and manual journals |
+| Items & tracking | Items and tracking categories |
+| Reports | Profit and loss, balance sheet, trial balance, and aged receivables/payables |
+| Payroll | Employees, leave, leave types, and timesheets (NZ and UK organisations) |
+
+The server is the source of truth for tool names and schemas.
+
+## Notes
+
+- This is a local stdio server, so `npx` has to be available on the machine running Cursor. It downloads `@xeroapi/xero-mcp-server` on first run.
+- Xero's own FAQ says the server works with any client supporting local stdio servers, and that its testing was done with Claude Desktop and Cursor.
+- Tool calls run with the scopes granted to the Custom Connection, against the one organisation it is bound to. To work with several organisations, create a connection per organisation.
+- To narrow the surface further, add a space-separated `XERO_SCOPES` value to the server's `env` — for example `accounting.invoices accounting.contacts accounting.settings`.
+- `xero-mcp` by john-zhang-dev is a community package, and JAX is Xero's in-product assistant. Neither is this server.
+
+## Docs
+
+- Xero MCP server: https://github.com/XeroAPI/xero-mcp-server
+- Xero AI and MCP: https://developer.xero.com/ai
+- Custom Connections: https://developer.xero.com/documentation/guides/oauth2/custom-connections/
+- npm package: https://www.npmjs.com/package/@xeroapi/xero-mcp-server
+
+Logo is Xero's official mark, from the `XeroAPI` GitHub organization.
+
+## License
+
+MIT
diff --git a/third_party/xero/assets/logo.png b/third_party/xero/assets/logo.png
new file mode 100644
index 00000000..6c33f67c
Binary files /dev/null and b/third_party/xero/assets/logo.png differ
diff --git a/third_party/xero/mcp.json b/third_party/xero/mcp.json
new file mode 100644
index 00000000..52ba6ec0
--- /dev/null
+++ b/third_party/xero/mcp.json
@@ -0,0 +1,16 @@
+{
+ "mcpServers": {
+ "xero": {
+ "type": "stdio",
+ "command": "npx",
+ "args": [
+ "-y",
+ "@xeroapi/xero-mcp-server@latest"
+ ],
+ "env": {
+ "XERO_CLIENT_ID": "${XERO_CLIENT_ID}",
+ "XERO_CLIENT_SECRET": "${XERO_CLIENT_SECRET}"
+ }
+ }
+ }
+}