Skip to main content

NetSuite

NetSuite's AI Connector Service is an MCP server on your account, at https://{accountId}.suitetalk.api.netsuite.com/services/mcp/v1/all. The path must end in /all, or in /suiteapp/{id} for one SuiteApp. Without that suffix the connection looks disconnected. NetSuite does not register clients for you. An admin creates an OAuth 2.0 integration and pastes its client ID into Willow. Each person then signs in with a non-administrator role. It is the NetSuite card with the Official badge. Willow also has a built-in NetSuite connector.

Before you start​

In Setup → Company → Enable Features → SuiteCloud, enable Server SuiteScript and OAuth 2.0. Enable REST Web Services if you use the MCP Standard Tools SuiteApp.

The Administrator role cannot use this service. Create or edit a non-administrator role and add:

  • MCP Server Connection
  • Log in using OAuth 2.0 Access Tokens (not "Log in using Access Tokens")
  • REST Web Services, if you use the standard tools SuiteApp

Assign that role to everyone who will connect.

Set up the integration record​

  1. Go to Setup → Integration → Manage Integrations → New.
  2. Enable Authorization Code Grant. Enable Public Client if NetSuite shows it.
  3. Under OAuth 2.0 scopes, check NetSuite AI Connector Service only. Clear REST, RESTlet, SuiteAnalytics, token-based authentication, and client-credentials boxes.
  4. Set Redirect URI to the URI from Willow's setup step.
  5. Save. Copy the Client ID. NetSuite shows it once. Copy the client secret too if the record is not a public client.

The mcp scope is used on its own. PKCE (S256) is required for this scope.

Set up Willow​

  1. Go to MCP Servers → + Add MCP server, open the NetSuite card with the Official badge, and click + Use.
  2. Enter the account ID. Confirm the URL ends in /services/mcp/v1/all.
  3. Keep OAuth sign-in. Paste the Client ID and, if you have one, the Client Secret.
  4. Click Check connection and sign in with the non-administrator role. Assign groups and Publish.

Troubleshooting​

The server looks disconnected​

Cause: The URL does not end in /all or /suiteapp/{id}.

Solution: Use https://{accountId}.suitetalk.api.netsuite.com/services/mcp/v1/all.

Sign-in works and then every tool is forbidden​

Cause: The user signed in with the Administrator role, or the role is missing MCP Server Connection.

Solution: Sign in with the role you granted those permissions to.

Additional Resources​