Back to MCP Servers

NetSuite MCP Server

Official Oracle NetSuite MCP server (AI Connector Service) providing natural language access to ERP records, transactions, reports, saved searches, and SuiteQL.

Payments by Oracle NetSuite OAuth2 active
Overview

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
Setup Guide

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 Connection and Login using OAuth 2.0 Access Tokens permissions

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.

Use Cases
  • 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_getRecordTypeMetadata and ns_getSuiteQLMetadata so the AI can self-correct field names and joins before writing queries
Example Prompts
  • "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."
Pros
  • 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
Limitations
  • 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
Alternatives
  • 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