1. Home
  2. NetSuite integration
  3. NetSuite MCP

NetSuite MCP: Oracle's own server, a free tool SuiteApp, and the role rules that limit it

Yes, NetSuite supports MCP. Oracle's NetSuite AI Connector Service is the official MCP server, and its free MCP Standard Tools SuiteApp listed 25 tools when we counted them in Oracle's tool table on 18 November 2026. A tool shows only if the role you sign in with holds its permissions, and Oracle does not allow the Administrator role.

Checked 18 November 2026

Yes: the AI Connector Service is NetSuite’s MCP server

Oracle’s help says NetSuite “has adopted the Model Context Protocol (MCP)”. MCP is an open-source standard for connecting AI apps to other systems. In NetSuite, the server is called the NetSuite AI Connector Service. Oracle’s ready-made tools come in the MCP Standard Tools SuiteApp, an add-on you install from the SuiteApp Marketplace.

Both are free. Oracle calls the service “not a paid feature” and the MCP Standard Tools SuiteApp a free SuiteApp. Your AI client may still need a paid plan. For Claude, Oracle names the Pro plan or higher. The connector also spends no AI Units, the credits that NetSuite’s built-in AI uses.

Oracle’s 2026.2 release note for integration SuiteApps was updated on October 19, 2026. It names MCP Standard Tools SuiteApp version 3.0.0, which added File Cabinet tools, a runtime tool, and record tools that build a new record from an existing one. The same note adds record actions. We could not find the release in which Oracle first shipped the service, and no page we read calls it a beta.

What your AI client must support

Oracle lists four things a client needs:

  • Remote MCP. The server sits at a web address on NetSuite’s domain, suitetalk.api.netsuite.com.
  • Protocol version 2025-06-18. MCP names each version by a date. The MCP site gives 2026-07-28 as the current version, and each date marks a change that broke older clients. Ask your client’s vendor whether it still speaks 2025-06-18.
  • Streamable HTTP. MCP messages travel as web requests to one address.
  • OAuth 2.0 with PKCE. A standard sign-in. On the first connection, NetSuite asks you to allow or deny access to your account.

Oracle says Claude Pro and ChatGPT are supported now, some clients need extra setup, and any client that supports MCP can connect. Its connection page points to SuiteAnswers guides for Codex, Claude Code, Copilot Studio and Postman. Some ChatGPT plans need Developer Mode first.

Pick the server address: one SuiteApp or every tool

Each NetSuite account has its own MCP address, and an Administrator can give it to you. It comes in two forms:

Scroll the table sideways to see every column.

Address ends in What the AI client sees
/services/mcp/v1/suiteapp/<applicationid> Only the tools of one SuiteApp. For Oracle’s standard tools the ID is com.netsuite.mcpstandardtools
/services/mcp/v1/all Every custom tool in the account, from SuiteApps and from account customization projects (ACPs)

An application ID is the publisher ID, a dot, then the project ID. Both forms start with your account ID and suitetalk.api.netsuite.com. Oracle’s FAQ warns that if a client calls the general address without /all at the end, the connection looks disconnected.

The SuiteApp form is the narrow one. Use it when you want the AI to see Oracle’s tool set and nothing your developers added.

The 25 standard tools and the permission each needs

We counted 25 tool names, in seven groups, in the List of Available Tools table on Oracle’s page “Available Tools in the MCP Standard Tools SuiteApp”, in the copy we saved on 18 November 2026. Oracle’s six MCP Apps have tool names of their own and are not in the 25. A tool shows up in the AI client only when your role holds every permission it needs.

Scroll the table sideways to see every column.

Group Tools What they do Permission to see them
File Cabinet (6) ns_searchFiles, ns_attachFile, ns_detachFile and three path lookups Search file names and pin a file to a record or remove it None listed
Record (6) ns_createRecord, ns_getRecord, ns_updateRecord, ns_transformRecord and two metadata tools Add, read and edit records, or turn a sales order into an invoice REST Web Services (Full)
Record Action (2) ns_getRecordActionMetadata, ns_executeRecordAction Find and run the actions a record allows None needed to see; the role must allow the action
Report (6) ns_listAllReports, ns_runReport and four filter lookups List and run standard and custom reports None listed
Runtime (1) ns_getSessionInfo Show the account, role, features and permissions of the session None listed
Saved Search (2) ns_listSavedSearches, ns_runSavedSearch List and run saved searches Perform Search (View)
SuiteQL (2) ns_runCustomSuiteQL, ns_getSuiteQLMetadata Run read-only SuiteQL queries None needed to see; data follows the role

Oracle’s MCP Apps page lists six MCP Apps in the SuiteApp, such as ns_fileCabinet_app and ns_prompt_library_app. An MCP App shows a small screen inside the chat. One lets you pick an existing record, and another lets you choose a report’s filters.

Five rules shape what these tools can do:

  • No delete tool. The record tools add and edit records, and can build one record from another. We found none that deletes a record.
  • SuiteQL only reads. ns_runCustomSuiteQL runs read-only queries. Give it a page size and it pages through large results.
  • Record actions act at once. Oracle warns that an action “can immediately change data”. Bulk actions are out, and so are new actions or macros built from the chat.
  • The tools change. The SuiteApp is managed and updates itself, and Oracle says its tools “may be modified over time”. Test your prompts again after an update.
  • The folder counts too. Your role needs access to the SuiteApp’s folder in the File Cabinet, NetSuite’s file store.

Oracle’s own tips help here. Have the model try ns_runReport or ns_runSavedSearch before it writes SuiteQL. Set an External ID on every record ns_createRecord makes, so a repeated prompt does not create a duplicate.

Sign-in uses OAuth 2.0 and a non-Administrator role

No user has MCP access until an admin grants it to a role. Oracle’s setup has two parts:

  1. Turn on Server SuiteScript and OAuth 2.0, plus REST Web Services for the standard tools.
  2. Sign in with a role that holds MCP Server Connection and OAuth 2.0 Access Tokens.

Oracle’s troubleshooting list flags a slip: the role needs “OAuth 2.0 Access Tokens and not Access Tokens”. Administrator fails.

After your first Claude connection, NetSuite installs an integration record on its own. An admin can switch that record off or give it a fixed share of the account’s concurrency limit. For other clients, check whether installing the SuiteApp created an integration record. If it did, it starts as pending until an Administrator enables it. If not, you create one by hand. ChatGPT with custom tools needs a new integration record for each new connection.

A token with the mcp scope cannot carry any other scope. Keep MCP access and a REST integration on separate tokens.

To connect in Claude, Oracle’s steps start at Search and tools, then Add connectors, then the NetSuite AI connector on the Web tab. In ChatGPT, open Apps in the sidebar and search for the NetSuite app. Pick a role that is not Administrator when NetSuite asks you to sign in.

Custom tools run inside NetSuite, under tight limits

When the standard tools do not fit, your developers can write custom tools in SuiteScript 2.1, NetSuite’s JavaScript. Each tool set needs three files: a script whose header says @NScriptType CustomTool, a JSON-RPC schema that names and describes each tool, and a toolset SDF object. SDF, the SuiteCloud Development Framework, is how code moves from Oracle’s developer kit into an account.

These limits come from Oracle’s pages:

  • 1,000 usage units per run. Usage units are NetSuite’s meter for script work.
  • No outside calls. A tool script cannot load N/http, N/https, N/llm or N/sftp.
  • The old format is gone. Since the September 2026 minor release, custom tools cannot deploy with tool XML definitions. The tool SDF object will be deprecated in 2027.1, so move to the toolset object now.
  • Edits go through SDF. Once deployed, the script, schema and HTML files cannot be edited in the File Cabinet.
  • Checked at deploy. From the August 2026 monthly release, NetSuite checks the script against its schema and stops a deployment that fails.
  • Whole toolsets switch on and off. Only tools in active toolsets can be found. Only the Administrator role can activate a toolset.
  • Files need a list. If Allowed File Cabinet Access is empty, custom tools cannot touch a single file. The list takes up to 1,000 folders. Oracle warns that opening the SuiteScripts folder could expose your script code.

A custom tool can show its own screen in the chat by adding the _meta.ui.resourceUri property to its schema. Oracle keeps sample tools in an MCP-Sample-Tools folder on GitHub. Only changes made by custom tools show in the AI Used column of System Notes, NetSuite’s change log. Edits made through Oracle’s standard tools are not marked there.

Every MCP call shares your account’s concurrency limit

The connector draws on the same pool of concurrent requests as your other integrations. That holds unless an admin gives its integration record a share of its own. Oracle’s example: an account with a limit of five assigns two to a REST integration, so the AI connector can use only the three left.

Expect more requests than prompts. Oracle says each tool call is usually preceded by extra requests that MCP itself requires. Past the limit, a request fails with “Too Many Requests”. The client can retry, and Oracle suggests reviewing the account’s concurrency limit. AI clients also tend to handle about 5,000 rows per call, and large queries may time out. The account’s limit is its service tier’s base, plus 10 for each SuiteCloud Plus licence. Our NetSuite integration page lists each tier’s base.

The integration record keeps an execution log of MCP calls. Each entry shows the time, how long the call took, its status and the user’s email. Oracle keeps it 21 days in production and seven in a sandbox.

Oracle adds prompts and record access month by month

Oracle’s Companion SuiteApp holds ready-made prompts written for these tools. Since the August 2026 monthly release it supports 23 languages. You find the prompts under Setup, AI Companion Tools, AI Companion Library. Oracle also publishes a netsuite-ai-connector-instructions skill file on its SuiteCloud SDK GitHub page, for AI clients that load skills.

Oracle’s help update of October 19, 2026 added pages on bank reconciliation records that AI clients can reach. With them, a client can read reconciliation data and accept or reject matching suggestions.

Community NetSuite MCP servers are not Oracle’s

Developers outside Oracle have put their own NetSuite MCP servers on GitHub. Oracle did not build them. Here are two examples, from their own repository pages read on 18 November 2026:

  • dsvantien/netsuite-mcp-server is a program the AI client starts on your machine and talks to over stdio, its standard input and output. It signs in with OAuth 2.0 and PKCE. Its README says Oracle’s AI Connector SuiteApp is still required. It also says Oracle’s connector works only with Claude on the web and ChatGPT, yet Oracle’s own connection page now points to guides for Claude Code and Codex.
  • CDataSoftware/netsuite-mcp-server-by-cdata is deprecated and archived, and CData no longer maintains it. It was a local, read-only server built on CData’s JDBC driver.

A community server sits between your AI client and your ERP. Oracle says it cannot control how outside MCP servers handle tokens or data once the data leaves NetSuite. Oracle’s advice is to use only trusted and approved clients, servers and tools.

When MCP is enough, and when a job needs an agent

MCP lets a person work with NetSuite in plain language from a chat window. Oracle’s FAQ still says AI clients can give wrong answers, so check results against NetSuite. A job that should start when an email lands, with no one typing a prompt, needs software that runs outside the chat. Our NetSuite AI agents page covers that kind of build.

Our team has taken NetSuite live.

The first call is free.

Questions

Does NetSuite support MCP?

Yes. Oracle's help says NetSuite has adopted the Model Context Protocol, and the NetSuite AI Connector Service is the server. Install Oracle's free MCP Standard Tools SuiteApp and an AI client gets tools for records, reports, saved searches, SuiteQL and files. Oracle's 2026.2 release note names version 3.0.0 of that SuiteApp. The client has to support protocol version 2025-06-18, Streamable HTTP and OAuth 2.0 with PKCE.

What API integrations are available for NetSuite?

Oracle documents these routes. REST web services create, read, update and delete records, and run SuiteQL queries that return at most 100,000 results. RESTlets are your own SuiteScript that outside software can call. SuiteAnalytics Connect also runs SuiteQL. SOAP web services still work, but Oracle turns them off with release 2028.2. The AI Connector Service is the route for MCP clients.

Is the NetSuite MCP server free?

On Oracle's side, yes. Oracle says the AI Connector Service is not a paid feature and the MCP Standard Tools SuiteApp is free. It also uses no AI Units, so it leaves the units for NetSuite's own AI alone. Your AI client is a separate bill. For Claude, Oracle says you need the Pro plan or higher, and some ChatGPT plans need Developer Mode turned on.

Which AI clients can connect to NetSuite through MCP?

Oracle names Claude Pro and ChatGPT as supported today. It also says any client that supports MCP can connect, if it meets the four rules: remote MCP, protocol version 2025-06-18, Streamable HTTP, and OAuth 2.0 with PKCE. Oracle's connection page points to SuiteAnswers guides for Codex, Claude Code, Copilot Studio and Postman. For other clients, you may need to create the integration record by hand.

Can an AI client delete NetSuite records through MCP?

Not with Oracle's standard tools, as far as the tool list we read shows. Its record tools add and edit records, and can turn a sales order into an invoice, but none deletes. Record actions are different. Oracle warns that an action run from an AI client can change data at once. Oracle suggests a separate role with the MCP Server Connection permission and only the record and action permissions users need through the AI client. Review each action before it runs.

Can we use the NetSuite MCP server with patient health data?

Not without your own compliance review. Oracle says the AI Connector Service has not been assessed for HIPAA, the US health privacy law. It tells customers not to send protected health information through it unless they have decided for themselves that the use fits their HIPAA duties. Oracle also says it cannot control what happens to data after it leaves NetSuite.

Sources

Every source behind a figure or a vendor fact on this page, with the day we read it.

Choose the NetSuite role your AI client signs in with

The first call is free. Bring the jobs you want an AI client to do in NetSuite and the roles your team uses now, and we can talk through which tools each job needs.

Book a NetSuite MCP call