Gl Importer MCP server

Read from the package source without running it. The installed server may list more.

• account_get

  Returns the current Synder Importer account: email, name, status, subscription, and connected-company count. Call this first to verify the IMPORTER_API_TOKEN is valid.

• companies_list

  Lists all accounting companies connected to the Importer account (QuickBooks Online via 'intuit', Xero via 'xero'). Use the returned 'id' as companyId for downstream tools.

• entities_list

  Lists importable entity types for a company (Invoice, Bill, JournalEntry, Customer, Vendor, etc.). Use the returned 'name' as entityName for fields_get and import tools.

• fields_get

  Returns the field schema for an entity in a company: every field with its type, required flag, alternativeTitles, and predefinedValues. Use to build or verify a mapping before running an import.

• import_autowrite action

  Uploads a file and asks the server to auto-map columns to the target entity. Set dryRun=true to get the proposed mapping back without creating an import — useful for showing the user what will happen and asking 'does this look right?' before committing. Set dryRun=false (default) to auto-map and import in one call.

• import_cancelwrite action

  Cancels a SCHEDULED or IN_PROGRESS import. Already-imported rows are NOT rolled back — use import_revert for that. Returns the updated import status.

• import_csv

  Happy-path CSV/XLSX importer. Two-step: first call (without confirmed) auto-resolves the company, uploads the file, and returns the server's proposed mapping plus any missingRequired fields — show this to the user. Re-call with confirmed=true (and the same filePath) to run the real import and poll until it terminates. Returns { stage: 'DRY_RUN' | 'DONE', importId?, status, summary?, proposedMappin

• import_executewrite action

  Uploads a CSV/XLSX file and starts an import using an existing mapping. The MCP server reads the file from disk — pass an absolute path. Returns the created import object including importId. Status starts as SCHEDULED — poll import_status or use import_wait. Limits: .csv/.xlsx/.xls only, 50MB max.

• import_results

  Returns per-row results for a finished import. Filter by 'type' (INFO / WARNING / ERROR) to surface only failures. Paginated — defaults to 20 rows per page, max 100.

• import_revert

  Reverts a FINISHED or FINISHED_WITH_WARNINGS import — deletes the QuickBooks/Xero entries the import created, using their live SyncTokens. Status transitions FINISHED → REVERTING → REVERTED. Confirm with the user before calling — irreversible from their perspective.

• import_status

  Returns a single import's current status and summary (total / succeeded / failed / warnings). Status lifecycle: SCHEDULED → IN_PROGRESS → FINISHED | FINISHED_WITH_WARNINGS | FAILED | CANCELED. FINISHED can transition to REVERTING → REVERTED.

• import_wait

  Polls import_status until the import reaches a terminal state (FINISHED, FINISHED_WITH_WARNINGS, FAILED, CANCELED, REVERTED). Exponential backoff (2s → 1.5× → cap 30s). Default timeout 600s — if exceeded, returns { status: 'POLLING', importId, lastSeen } so the LLM can re-call. Includes a per-type result count summary on terminal states (INFO / WARNING / ERROR; null if the server didn't return tot

• imports_list

  Lists recent imports for a company with status and timestamps. Use to find an importId for status / results / revert / cancel.

• mapping_createwrite action

  Creates a new field mapping for an entity (e.g. 'Journal Entry', 'Bill', 'Invoice'). Look up valid target fields with fields_get first. Returns the created mapping including its id.

• mapping_deletewrite action

  Deletes a saved mapping. Irreversible. Imports that referenced this mapping keep their historical record but new imports can no longer pick it.

• mapping_updatewrite action

  Replaces an existing mapping in full. Fetch the current mapping with mappings_list first and send the whole desired shape — this is a PUT, not a patch. Returns the updated mapping.

• mappings_list

  Lists field mappings saved for a company. Each mapping is reusable across imports of the same entity type.

• settings_get

  Returns per-company import settings (dateFormat, document-number behavior, product/account auto-creation, duplicate-skip). Check dateFormat before importing — CSV date columns must match.

• settings_updatewrite action

  Updates per-company import settings. Pass only the fields you want to change inside 'settings' (e.g. { dateFormat: 'dd/MM/yyyy' }). Fetch current values with settings_get first so you don't clobber unrelated fields. Returns the updated settings.

• Code scan25 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 76 days ago12/15
• Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10

Safety score

75/100

higher than 50% of 1,765 Finance servers

Tools

19

the typical Finance server has 8

Tools that change things

37%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

46

more than 45% of 413 Finance servers with a package

Gl Importer: common questions

Is Gl Importer MCP server safe?

Mostly: it is graded B (75/100). Read the Gl Importer safety report

How do I install Gl Importer?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Gl Importer need an API key?

Yes. The registry entry asks for IMPORTER_API_TOKEN.

Is Gl Importer maintained?

The last commit was 112 days ago (2026-07-13). The latest release is v0.1.1.

What can I use instead of Gl Importer?

Servers from other publishers that do the same job: E Arveldaja MCP server, Quickbooks MCP server and Quickbooks MCP server.

How does Gl Importer compare with other Finance MCP servers?

safety score 75/100 (higher than 50% of 1,765 Finance servers); tools 19 (the typical Finance server has 8); tools that change things 37% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.