NetSuite MCP for Claude — SuiteQL and REST Setup

A NetSuite MCP server connects Claude to an Oracle NetSuite account through SuiteTalk — the REST record service and SuiteQL, NetSuite's SQL-like query language over the record catalogue. There is no first-party NetSuite MCP; you connect with a community server or a thin one built on SuiteTalk. Because NetSuite accounts are heavily customised, most teams build their own against their specific record model.

How a NetSuite MCP connects

1. Enable the features. In Setup → Company → Enable Features, turn on SuiteTalk (REST Web Services) and, for scripted queries, SuiteQL.
2. Create an integration record and choose an auth method:
   • Token-Based Authentication (TBA) — an integration consumer key/secret plus a per-user token key/secret, signed with OAuth 1.0a. The common choice for a server-to-server connector.
   • OAuth 2.0 — authorization-code or client-credentials flow, for connectors that need a standard token lifecycle.
3. Expose the tools. A useful NetSuite MCP exposes a suiteql tool (arbitrary read queries over transactions, entities, items, accounts), a get_record / list_records pair over the REST record service, and wrappers for the saved searches your team already relies on.
4. Add it to claude_desktop_config.json with the account ID and credentials as environment variables. Restart Claude Desktop and confirm with a SuiteQL query.

What you can do once connected

• "Run a SuiteQL query for all vendor bills posted this quarter over $10,000, with vendor, amount, department and approval status."
• "Pull the income statement from NetSuite for the last three months by subsidiary and write the consolidated variance commentary against budget."
• "List open sales orders older than 30 days that have not been fulfilled, grouped by customer and sales rep."
• "From the saved search 'AR Aging Detail', draft a collections summary for every customer with a balance over 60 days."

Where the MCP connector stops

The NetSuite MCP returns records and query results and, in write mode, creates or updates records. It does not perform the financial computations that sit outside the system of record — ASC 842 lease schedules, ASC 606 revenue allocation beyond NetSuite's own arrangement handling, multi-entity elimination logic you want to model independently, depreciation modelling, or forward-looking three-statement forecasts. Run ClaudeFinanceLab's Accounting MCP alongside it for that layer and the drafted narrative.

NetSuite MCP vs. a SuiteApp or integration

A SuiteApp or an iPaaS integration bakes logic into NetSuite or a middleware layer and runs unattended. A NetSuite MCP gives an analyst conversational, ad-hoc access to the same data inside a Claude session — better for investigation, monthly review, and one-off analysis than for a production pipeline.

ClaudeFinanceLab's NetSuite connector

ClaudeFinanceLab maintains an open, read-only reference NetSuite MCP server (netsuite_mcp). It signs each request with Token-Based Authentication (OAuth 1.0a, HMAC-SHA256) and exposes a suiteql tool (paged, SELECT/WITH only), plus get_record and list_records over the REST record service. Install it with pip install claudefinancelab-mcp (console script netsuite-mcp) and run it self-hosted with your integration consumer key/secret and access token id/secret in the environment. Because NetSuite accounts are heavily customised, treat it as a starting point to extend against your record model.

Related guides

• QuickBooks MCP for Claude
• Xero MCP for Claude
• Cloud-Native Investment Accounting AI — API-first accounting platforms and AI
• The Finance MCP Server Guide

Frequently Asked Questions

Is there an official NetSuite MCP server?

Not from Oracle as of 2026. You connect through SuiteTalk (REST record service plus SuiteQL) with a community MCP server or, more commonly, a thin server built against your account's customised record model.

What authentication does a NetSuite MCP use?

Usually Token-Based Authentication (TBA) — an integration consumer key/secret plus a per-user token, signed with OAuth 1.0a — for server-to-server access. OAuth 2.0 is also supported for connectors that need a standard token lifecycle. Both require an integration record and the SuiteTalk feature enabled.

What is SuiteQL and why does it matter for an MCP?

SuiteQL is NetSuite's SQL-like query language over the record catalogue. A single suiteql MCP tool lets Claude answer most read questions — transactions, balances, aging, spend by dimension — without a wrapper per report, which is why it is the core of a useful NetSuite MCP.

What can't a NetSuite MCP do?

It is a data-access layer. It will not build independent ASC 842 / ASC 606 schedules, model consolidation logic outside NetSuite, run depreciation modelling, or produce forecasts — those sit on top of the data, which is what ClaudeFinanceLab's Accounting MCP adds.