Setting Up Claude AI with NetSuite Using MCP: A Step-by-Step Configuration Guide

Introduction

In our previous post, we explored the many ways AI tools like Claude can simplify your NetSuite work. In this guide, we’re going deeper — walking through how to set up a direct, real-time connection between Claude and your NetSuite account using Anthropic’s Model Context Protocol (MCP).

With MCP, Claude can read data directly from NetSuite, run saved searches, look up records, and even help you take actions — all through a conversational interface. This is a game-changing setup for NetSuite power users and developers.

What is the Model Context Protocol (MCP)?

MCP is an open standard developed by Anthropic that allows Claude to securely connect to external tools, APIs, and data sources. Instead of copying and pasting data into Claude manually, MCP lets Claude retrieve information in real time. For NetSuite users, this means Claude can directly query your NetSuite environment during a conversation.

Prerequisites

Before you begin, make sure you have the following:

• An active NetSuite account with Administrator or full API access
• A Claude Pro or Claude for Teams subscription (MCP requires Claude Desktop or API access)
• Claude Desktop app installed on your computer (available at claude.ai/download)
• Basic familiarity with NetSuite’s REST API or SuiteTalk Web Services
• Node.js installed on your machine (version 18 or higher)

Step 1: Generate Your NetSuite API Credentials

To allow Claude to connect to NetSuite, you’ll need to set up Token-Based Authentication (TBA) in NetSuite:

1. Log into NetSuite and go to Setup > Integration > Manage Integrations
2. Click New to create a new integration record
3. Give it a name (e.g., “Claude MCP Integration”), enable Token-Based Authentication, and save
4. Note the Consumer Key and Consumer Secret — you’ll need these
5. Go to Setup > Users/Roles > Access Tokens and create a new token for your user
6. Note the Token ID and Token Secret
7. Also note your Account ID (found under Setup > Company > Company Information)

Step 2: Install the NetSuite MCP Server

Anthropic and the community have developed MCP server packages for various platforms. For NetSuite, you can use an open-source NetSuite MCP connector. In your terminal, run:

npm install -g netsuite-mcp-server

Or if you’re using a community-built connector from GitHub, clone the repository and follow its setup instructions:

git clone https://github.com/your-org/netsuite-mcp-server
cd netsuite-mcp-server
npm install

Step 3: Configure the MCP Server with Your NetSuite Credentials

Create a configuration file (e.g., netsuite-config.json) with your NetSuite credentials:

{
  "accountId": "YOUR_ACCOUNT_ID",
  "consumerKey": "YOUR_CONSUMER_KEY",
  "consumerSecret": "YOUR_CONSUMER_SECRET",
  "tokenId": "YOUR_TOKEN_ID",
  "tokenSecret": "YOUR_TOKEN_SECRET",
  "restApiVersion": "2024.1"
}

Important: Never commit this file to a public repository. Add it to your .gitignore file.

Step 4: Configure Claude Desktop to Use the MCP Server

Open the Claude Desktop configuration file. On Windows it’s located at:

%APPDATA%\Claude\claude_desktop_config.json

On Mac it’s at:

~/Library/Application Support/Claude/claude_desktop_config.json

Add the NetSuite MCP server to the configuration:

{
  "mcpServers": {
    "netsuite": {
      "command": "node",
      "args": ["/path/to/netsuite-mcp-server/index.js"],
      "env": {
        "NETSUITE_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "NETSUITE_CONSUMER_KEY": "YOUR_CONSUMER_KEY",
        "NETSUITE_CONSUMER_SECRET": "YOUR_CONSUMER_SECRET",
        "NETSUITE_TOKEN_ID": "YOUR_TOKEN_ID",
        "NETSUITE_TOKEN_SECRET": "YOUR_TOKEN_SECRET"
      }
    }
  }
}

Step 5: Restart Claude Desktop and Test the Connection

Restart the Claude Desktop application. You should see the NetSuite integration appear as an available tool. Try a test prompt like:

• “Show me all open Sales Orders from this month”
• “Find the customer record for Acme Corporation”
• “What are the top 10 items by revenue this quarter?”
• “List all vendors with outstanding bills over 90 days”

Claude will use the MCP connection to query your NetSuite data in real time and return results directly in the chat.

Step 6: Set Up Role-Based Access for Security

It’s important to ensure the NetSuite role associated with your API token follows the principle of least privilege. Create a dedicated integration role in NetSuite with only the permissions required for your Claude use cases — read-only access to specific record types is recommended to start.

What Can You Do Once It’s Set Up?

Once Claude is connected to NetSuite via MCP, the possibilities are broad:

• Natural language reporting: Ask Claude for business insights without building saved searches
• Record lookup: Instantly find customer, vendor, or inventory records by description
• Data validation: Ask Claude to check for data quality issues across records
• SuiteScript help in context: Claude can see your actual field names and schema when helping write scripts
• Workflow troubleshooting: Claude can review recent transaction data to help diagnose workflow issues

Troubleshooting Common Issues

If you encounter errors connecting Claude to NetSuite, here are the most common issues and fixes:

• 401 Unauthorized: Double-check your Consumer Key/Secret and Token ID/Secret. Ensure TBA is enabled on the integration record.
• 403 Forbidden: The NetSuite role doesn’t have sufficient permissions. Review and grant the necessary record access.
• Connection timeout: Check your Account ID format — it should match the format shown in NetSuite (e.g., 1234567 or 1234567_SB1 for sandbox).
• MCP server not showing in Claude: Verify the path in your Claude Desktop config file is correct and that Node.js is accessible from your system PATH.

Conclusion

Setting up Claude with NetSuite via MCP transforms Claude from a general-purpose AI assistant into a NetSuite-aware business intelligence tool. With real-time data access, you can get answers, reports, and insights faster than ever — simply by asking in plain English.

This integration is particularly powerful for NetSuite administrators, business analysts, and consultants who need quick access to data without running reports manually. Give it a try in your Sandbox environment first, and once you’re comfortable, deploy it for your production instance.

Have questions about the setup? Drop them in our Community Q&A section and our experts will help you get connected!