NetSuite with Claude: the connector, its tools and its limits

How does Claude connect to NetSuite?

Through the Model Context Protocol. Oracle runs an MCP server inside NetSuite, the NetSuite AI Connector Service, at an address per account:

https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools

The first URL returns every tool installed in the account; the second only the tools of one SuiteApp. Oracle's FAQ names a missing /all as the reason Claude shows "connected" while the connector stays disconnected.

The tools themselves come from a SuiteApp. Oracle's MCP Standard Tools SuiteApp is free and covers the common work. What has to be in place before the first prompt:

Sign-in is OAuth 2.0 with the user's own NetSuite login. Claude sees what that role sees and nothing more.

What can Claude do in NetSuite?

The standard tools come in four groups, 14 tools in total, as listed on October 3, 2026:

Two lines in Oracle's own best practices matter for a finance team. Have Claude run a report or a saved search before it writes SuiteQL. And do not use SuiteQL for financial reports, because the standard reports apply business rules that a query does not. A revenue figure Claude assembles with SELECT SUM(amount) FROM transactionline will differ from the income statement whenever the report's rules for posting, consolidation or currency apply.

Can Claude write to NetSuite?

Yes. ns_createRecord and ns_updateRecord create and change records through REST web services. Oracle's warning is plain: a user whose role has the MCP Server Connection permission can perform these actions on any record available through REST, if the role's permissions allow it. A buyer who may edit vendors in the UI may edit them through Claude.

Three controls keep writes contained:

• A separate role for AI use, with MCP Server Connection and only the record permissions that role needs.
• Tool permissions in Claude. Per tool or per group: Always allow, Needs approval or Blocked. Write tools on Needs approval means every create or update is shown before it runs.
• An external ID on every record Claude creates. Oracle recommends setting externalId on ns_createRecord. A prompt that is retried, or asked twice, then updates the record instead of creating a duplicate. The same rule applies to an order sync, as explained in duplicate customers and orders.

How many questions fit in the limits?

Three limits apply at the same time.

Concurrency, shared with every integration. Unless an administrator allocates a limit to the AI Connector's integration record, Claude draws on the account's pool of concurrent requests. That pool is 5 on the Standard service tier, 15 on Premium and 20 on Enterprise and Ultimate, plus 10 per SuiteCloud Plus license. Oracle's own example: with a limit of 5 and 2 allocated to a REST integration, the AI Connector can use the remaining 3. One prompt is not one request: MCP sends protocol requests before the tool call. A request over the limit gets Too Many Requests, and the AI client has to retry.

Rows per call. Oracle's FAQ puts the practical ceiling of AI clients at about 5,000 rows per call. Claude's own documentation limits a tool result to about 150,000 characters. A SuiteQL row with item number, name, location, quantity and amount runs to about 90 characters as JSON. 150,000 divided by 90 is 1,666 rows, well below 5,000. A question about 4,200 items at 3 locations, 12,600 rows, takes at least 8 calls.

Usage units per custom tool. A custom tool script has 1,000 usage units per execution. Loading a sales order costs 10 units and saving it 20. 1,000 divided by 30 is 33 orders per call, so a tool that updates 120 orders needs 4 calls. The full table of units is on NetSuite concurrency and governance limits.

When the standard tools are not enough

Custom tools are SuiteScript 2.1 scripts with a JSON-RPC schema that describes each tool, deployed as a toolset SDF object through the SuiteCloud Development Framework. They make sense for a fixed question asked daily, such as open orders past their ship date per customer, where one tool returns exactly the rows needed instead of letting Claude compose SuiteQL each time.

Two restrictions shape what a custom tool can be:

• The modules N/http, N/https, N/llm and N/sftp are not supported. A custom tool cannot call Shopify, a WMS or a carrier. A question that spans NetSuite and the store needs a second MCP server outside NetSuite, or data that an integration already brought into NetSuite.
• Since the September 2026 minor release, custom tools can no longer be deployed with the old tool XML definition; they use the toolset object. The tool object is deprecated in NetSuite 2027.1.

Claude next to an order sync

Claude answers when someone asks. An order sync runs whether anyone is looking or not: every order from the store reaches NetSuite once, with retries and backoff when NetSuite answers Too Many Requests and a queue that holds orders through a busy hour. Both run on the same account, so they affect each other.

The AI Connector keeps its own log. Each integration record has an Execution Log tab with a subtab for AI Connector Service (MCP): time, duration, status, user, HTTP status, method and URL path per request. Production keeps 21 days, a sandbox 7. When the order sync starts seeing 429s at 10 am every day, that log shows whether the same hour has a burst of MCP calls.

What this means for your integration

Claude is more useful on NetSuite data that is complete. When orders, customers and stock from the store are in NetSuite with stable external IDs, a question about last week's orders by state is answered from NetSuite alone. We build and run the NetSuite integration that puts that data there, with its own concurrency allocation so a busy hour of AI questions does not stall the order flow.

Custom MCP tools are part of the same work when a question needs a fixed, governed answer: a tool that returns exactly the rows the team asks for daily, within the 1,000 units a call allows. Tell us what you want to ask NetSuite, and we show you which part the standard tools cover.