NetSuite MCP Server

A Model Context Protocol server for interacting with NetSuite via the SuiteTalk REST API.

Install

Claude Desktop (one-click)

Download netsuite-mcp.mcpb and open it — Claude Desktop will prompt for your NetSuite credentials.

Claude Code

claude mcp add netsuite \
  -e NETSUITE_ACCOUNT_ID=your-account-id \
  -e NETSUITE_CONSUMER_KEY=your-consumer-key \
  -e NETSUITE_CONSUMER_SECRET=your-consumer-secret \
  -e NETSUITE_TOKEN_ID=your-token-id \
  -e NETSUITE_TOKEN_SECRET=your-token-secret \
  -- npx -y @aaronsb/netsuite-mcp

Manual (any MCP client)

{
  "mcpServers": {
    "netsuite": {
      "command": "npx",
      "args": ["-y", "@aaronsb/netsuite-mcp"],
      "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"
      }
    }
  }
}

Credentials

NetSuite uses OAuth 1.0 Token-Based Authentication (TBA):

1. Create an integration record: Setup > Integration > Manage Integrations > New. Enable Token-Based Authentication. Save the consumer key and secret.
2. Create an access token: Setup > Users/Roles > Access Tokens > New. Select the integration, user, and role. Save the token ID and secret.

Tools

| Tool | Description | |------|-------------| | manage_netsuite_record | Get, create, update, delete, or list any NetSuite record type | | run_suiteql | Execute SuiteQL queries (SQL-like syntax for NetSuite data) | | manage_saved_search | Execute or list saved searches | | get_record_metadata | Get field definitions, sublists, and relationships for a record type |

Each tool accepts an operation parameter to select the action. Use get_record_metadata to discover available fields before creating or updating records.

License

MIT License