Skip to main content

Set up the NetSuite MCP server

The NetSuite AI Connector Service gives AI clients access to your NetSuite ERP data and tools through the Model Context Protocol, enabling natural-language queries against records, transactions, and reports. This guide covers enabling required NetSuite features, installing the MCP Standard Tools SuiteApp, creating an OAuth integration record, and connecting to MintMCP.

Prerequisites​

  • A MintMCP admin account
  • A NetSuite account with Administrator access
  • NetSuite features enabled: Server SuiteScript, REST Web Services, and OAuth 2.0

Enable required NetSuite features​

  1. Go to Setup > Company > Enable Features
  2. On the SuiteCloud tab, check Server SuiteScript
  3. Under Web Services, check REST Web Services
  4. Under Manage Authentication, check OAuth 2.0
  5. Click Save

Install the MCP Standard Tools SuiteApp​

  1. Go to SuiteCloud > SuiteApp Marketplace
  2. Search for MCP Standard Tools
  3. Click Install and follow the prompts

Create a custom MCP role​

The NetSuite AI Connector Service does not work with the Administrator role.

  1. Go to Setup > Users/Roles > Manage Roles > New
  2. Enter a Name (e.g., MintMCP Role)
  3. On the Permissions subtab, add:
PermissionLevel
MCP Server ConnectionFull
OAuth 2.0 Access TokensFull
REST Web ServicesFull
  1. Add view or edit permissions on any records the MCP tools need to access (customers, transactions, inventory, etc.)
  2. Click Save
  3. Assign this role to each user who will connect to MintMCP

Create an OAuth integration record​

  1. Go to Setup > Integration > Manage Integrations > New
  2. Enter a Name: MintMCP
  3. Set State to Enabled
  4. On the Authentication subtab:
    • Check Authorization Code Grant
    • Check Public Client
    • Under OAuth 2.0 Scopes, check NetSuite AI Connector Service and clear all other scope checkboxes
    • In Redirect URI, enter: https://app.mintmcp.com/oauth/callback
  5. Click Save
  6. Copy the Client ID displayed on the confirmation screen. It is shown only once — store it securely before navigating away.

Find your NetSuite account ID​

Your account ID is the number at the start of your NetSuite URL. If your URL is https://123456.app.netsuite.com/, your account ID is 123456. Sandbox accounts include an underscore suffix (e.g., 123456_SB1).

You can also find it at Setup > Company > Company Information on the Company URLs subtab.

Add NetSuite to MintMCP​

  1. In MintMCP, go to MCP store > Manage store

  2. Click + Add an MCP to your registry → Connect to an MCP by URL

  3. Enter the server URL, replacing <accountid> with your account ID:

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

    To expose all custom tools from every installed SuiteApp and account customization project, use the /all endpoint instead:

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

  4. Set Connection type to Per-user credentials

  5. Set Authorization method to OAuth

  6. Open OAuth Client Advanced Settings and paste the Client ID copied from the integration record

  7. Click Create

Security considerations​

  • Each user authenticates with their own NetSuite account and role — actions are scoped to that user's permissions.
  • The Administrator role cannot be used with the AI Connector Service; assign the custom MCP role to users who connect.
  • The Client ID is displayed only once when the integration record is saved — store it securely before navigating away.
  • MCP tools can only read or modify data that the assigned role permits.

Next steps​