NetSuite MCP Server

The NetSuite MCP server lets your AI agents interact with your NetSuite ERP data through the REST API. Agents can retrieve and list records, inspect record type metadata, and run SuiteQL queries — all read-only.

Capabilities

Tool	What It Does
Get record	Retrieve a single record by type and internal ID
List records	List records of a specific type with pagination
Get record type metadata	Retrieve field definitions and metadata for a record type
Run SuiteQL	Execute a read-only SuiteQL query against the NetSuite database

📝 Note: All NetSuite tools are read-only. The agent cannot create, update, or delete records. SuiteQL queries are restricted to SELECT statements only.

OAuth Setup

The NetSuite MCP server uses OAuth to authenticate on behalf of each user. To enable this integration, you need to create an OAuth integration record in NetSuite and provide the credentials to Devs.ai.

Step 1: Enable OAuth 2.0 in NetSuite

1. Sign in to NetSuite as an administrator.
2. Go to Setup > Company > Enable Features.
3. Under the SuiteCloud tab, enable OAuth 2.0.

Step 2: Create an Integration Record

1. Go to Setup > Integration > Manage Integrations > New.
2. Enter a name (for example, "Devs AI").
3. Under Authentication, check OAuth 2.0 and select Authorization Code Grant.
4. Enter the redirect URL provided by your Devs.ai platform administrator.
5. Under Scope, enable REST Web Services.
6. Click Save.

Step 3: Get Your Credentials

1. After saving, NetSuite displays the Consumer Key (Client ID) and Consumer Secret (Client Secret).
2. Copy both values immediately — the Consumer Secret is only shown once.

Step 4: Configure in Devs.ai

1. Navigate to Organization > Connectors in Devs.ai.
2. Find the NetSuite template and click Enable.
3. Select OAuth as the authentication type.
4. Enter your Consumer Key (Client ID) and Consumer Secret (Client Secret) from Step 3.
5. Select the tools you want to make available.
6. Click Save.

When a user first interacts with an agent connected to NetSuite, they will be prompted to authorize access to their NetSuite account.

OAuth Configuration Reference

Field	Value
Authorization URL	https://system.netsuite.com/app/login/oauth2/authorize.nl
Token URL	https://{accountId}.suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token
Scopes	rest_webservices

📝 Note: Replace {accountId} with your NetSuite account ID (for example, TSTDRV1234567). The exact token URL depends on your account's data center.

Additional Resources

• NetSuite REST API Documentation
• NetSuite OAuth 2.0 Setup
• SuiteQL Reference