gl-importer-plugin is a Claude Code plugin developed by Synder Accounting, designed to let users directly use the Synder Importer API within the Claude Code environment to import accounting data in CSV or XLSX format into QuickBooks Online or Xero.
Main Capabilities
The plugin bundles an MCP server that wraps the Synder Importer REST API (/api/v1), providing full read and write capabilities, with a total of 19 tools covering the following categories: accounts, companies, settings, entities, fields, mappings, import, status polling, results, cancel, rollback, and two composite "shortcut" tools. In addition, the plugin includes the gl-importer agent skill (skills/gl-importer/SKILL.md), which provides natural language guidance for the two-step import process (dry run → confirm).
How to Use
Installation Requirements
- Node.js 18 or later
- Claude Code with plugin support (the /plugin command is available)
- A Synder Importer API token, which must be set in the shell environment as IMPORTER_API_TOKEN. The token can be generated at importer.synder.com under Account → API Keys.
Installation Methods
- Install from the Claude Code marketplace (recommended): use the /plugin command.
- One-click MCP installation for Claude Desktop: download the latest .mcpb package from Releases and double-click it; Claude Desktop will prompt for the API token.
- Install from source (for development).
Interacting with Claude Code
After installation, you can give instructions to Claude Code in natural language, for example:
- "Import ~/Downloads/march-bills.csv as Bills into my QuickBooks company."
- "What entities can I import into Xero?"
- "Show me the saved mapping called 'Stripe payouts' and update it to map Date → TxnDate."
- "List my last 10 imports and tell me which ones failed."
- "Revert import 12345 — I uploaded the wrong file."
The agent skill guides Claude Code through a safe two-step process: first perform a dry run, showing the suggested field mappings; then, after confirmation, actually create the import and poll until it finishes.
Commonly Used Tools
The MCP server outputs the full tool schema at startup. The tools most frequently used by the LLM include... (the specific tool list is not provided in the material).
Applicable Scenarios
Suitable for finance or accounting personnel who need to import CSV/XLSX accounting data into QuickBooks Online or Xero, using Claude Code to complete data import, mapping adjustments, status queries, and rollback operations in natural language.
Limitations
- Depends on Node.js 18+ and Claude Code plugin support.
- Requires a valid Synder Importer API token.
- Currently only supports importing into QuickBooks Online or Xero.
- Other feature limitations are not yet provided.
