NetSuite MCP Server
Official Oracle NetSuite MCP server (AI Connector Service) providing natural language access to ERP records, transactions, reports, saved searches, and SuiteQL.
The NetSuite AI Connector Service is Oracle's official remote MCP server for connecting AI assistants to NetSuite ERP data. Launched globally in August 2025, it is a provider-hosted MCP endpoint exposed directly from each NetSuite account at a URL based on the account ID. Connections are authenticated with OAuth 2.0 using the Authorization Code Grant flow, and every action runs through NetSuite's existing role-based permission model so an AI agent only sees and modifies what the connecting user is authorized to access.
The default capability set is delivered by the MCP Standard Tools SuiteApp, which exposes 16 tools across four categories: record CRUD (customers, vendors, items, transactions), report execution, saved search execution, and read-only SuiteQL queries with metadata discovery. Custom tools can be added via additional SuiteApps or Account Customization Projects, and the /all endpoint aggregates every tool exposed in the account. Administrator roles are intentionally blocked from connecting, so a dedicated custom role with the "MCP Server Connection" and "Login using OAuth 2.0 Access Tokens" permissions is required.
Because the server is hosted inside NetSuite itself, there is no local install, no JDBC driver, and no proxy. MCP clients such as Claude (Web and Desktop) and ChatGPT can register the URL as a remote connector and complete the OAuth flow in-browser. Execution logs are retained for 21 days in production accounts and 7 days in sandboxes for audit purposes.
Tools
| Tool | Description |
|---|---|
ns_createRecord |
Creates a new record in NetSuite (customers, vendors, items, transactions, etc.) |
ns_getRecord |
Retrieves a specific record from NetSuite by ID |
ns_updateRecord |
Updates an existing record in NetSuite |
ns_getRecordTypeMetadata |
Retrieves metadata for NetSuite record types, including available fields and data types |
ns_listAllReports |
Returns a list of all standard and custom reports in the NetSuite account |
ns_runReport |
Runs a financial or operational report and returns the results |
ns_getAccountingBooks |
Returns a list of accounting books that can filter report results |
ns_getAccountingContexts |
Returns a list of accounting contexts that can filter report results |
ns_getNexusIds |
Returns a list of nexuses that can filter report results |
ns_getSubsidiaries |
Returns a list of subsidiaries that can filter report results |
ns_listSavedSearches |
Returns a list of all saved searches in the NetSuite account |
ns_runSavedSearch |
Runs an existing saved search and returns the results |
ns_runCustomSuiteQL |
Executes a custom read-only SuiteQL query for ad hoc data analysis |
ns_getSuiteQLMetadata |
Retrieves metadata for NetSuite records accessible via SuiteQL, including fields, data types, and joinable fields |
Prerequisites
- A NetSuite account with administrator access for initial setup
- SuiteCloud features enabled: Client SuiteScript, Server SuiteScript, OAuth 2.0, REST Web Services
- The MCP Standard Tools SuiteApp (
com.netsuite.mcpstandardtools) installed from the SuiteApp Marketplace - A non-administrator custom role with
MCP Server ConnectionandLogin using OAuth 2.0 Access Tokenspermissions
Step 1: Install the SuiteApp
In NetSuite, go to Customization > SuiteCloud Development > SuiteApp Marketplace, search for NetSuite AI Connector / MCP Standard Tools, and install it. An integration record is created automatically with the NetSuite AI Connector Service scope enabled.
Step 2: Get your server URL
The remote MCP URL is account-specific. Replace <accountid> with your NetSuite account ID (lowercase, hyphenated for sandboxes, e.g. 1234567-sb1):
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools
To expose every tool installed in the account (Standard Tools plus any custom tools from other SuiteApps or ACPs), use:
https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/all
Step 3: Connect from Claude
In claude.ai, go to Search and tools > Add connectors, choose NetSuite under the Web tab, paste the Server URL, and click Continue. Then under Manage connectors, select NetSuite, click Connect, and approve the OAuth access request when redirected to NetSuite. Sign in with the non-administrator role you configured.
Step 4: Connect from Claude Desktop or other MCP clients
For clients that take a JSON config, add a remote MCP server entry pointing at the URL. Example shape:
{
"mcpServers": {
"netsuite": {
"url": "https://<accountid>.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools"
}
}
}
The client will trigger the OAuth Authorization Code flow on first use. Administrator roles are blocked, so make sure you sign in with the dedicated MCP role.
- Ask financial questions in natural language, such as running income statements or aged AR reports by subsidiary, accounting book, or nexus directly from Claude
- Look up customers, vendors, or transactions on demand, then create or update records (sales orders, invoices, bills) without leaving the chat
- Run existing saved searches conversationally and pipe the results into downstream analysis or summaries
- Execute ad hoc SuiteQL queries against any joinable record for finance, operations, or audit investigations
- Discover schema using
ns_getRecordTypeMetadataandns_getSuiteQLMetadataso the AI can self-correct field names and joins before writing queries
- "Run the income statement for the US subsidiary for Q1 and summarize the variance versus last year."
- "Find all open invoices for customer Acme Corp and show totals by aging bucket."
- "Create a new sales order for customer 1234 with two units of item SKU-001."
- "Use SuiteQL to list the top 20 vendors by spend in the last 90 days."
- "Run the saved search 'Overdue Invoices, by Sales Rep' and email me the top 10."
- Official Oracle NetSuite product, hosted by NetSuite with no local server to run or maintain
- Enforces existing NetSuite role-based permissions on every tool call, with execution logging for audit
- Comprehensive coverage of records, reports, saved searches, and SuiteQL in a single endpoint
- Extensible via custom tools built in SuiteScript 2.1 and exposed through additional SuiteApps or ACPs
- Administrator roles are blocked, so a dedicated custom role with specific permissions must be configured before first use
- Out-of-the-box tools are scoped to the MCP Standard Tools SuiteApp, so domain-specific workflows often require building custom tools
- Setup requires SuiteCloud features (SuiteScript, OAuth 2.0, REST Web Services) and SuiteApp installation, which is heavier than a typical SaaS connector
- CData NetSuite MCP Server: third-party read-only and managed read/write options using CData's JDBC engine and Connect AI platform
- SuiteInsider (@suiteinsider/netsuite-mcp): open-source Node.js MCP server that proxies to NetSuite via OAuth 2.0 PKCE for self-hosted setups
- glints-dev/mcp-netsuite: community open-source MCP server focused on SuiteQL queries and metadata retrieval