Netsuite MCP Server

NetSuite MCP server with OAuth 2.0 PKCE authentication. Works seamlessly with Claude Code, Cursor IDE, and other MCP clients.

Local serverstdio

What is the Netsuite MCP Server?

NetSuite MCP server with OAuth 2.0 PKCE authentication. Works seamlessly with Claude Code, Cursor IDE, and other MCP clients.

What you get

A Model Context Protocol (MCP) server providing access to NetSuite data through OAuth 2.0 with PKCE authentication. Works seamlessly with any MCP-compatible client including Claude Code, Cursor IDE, and Gemini CLI.

  • ✅ OAuth 2.0 with PKCE - Secure authentication without client secrets
  • ✅ Automatic Token Refresh - Tokens refresh automatically before expiration
  • ✅ Environment Variable Support - Configure credentials once in your MCP config
  • ✅ Session Persistence - Authentication survives server restarts
  • ✅ Universal MCP Integration - Works with Claude Code, Cursor IDE, Gemini CLI, and other MCP clients
  • ✅ NetSuite MCP Tools - Access to all NetSuite MCP capabilities (SuiteQL, Reports, Saved Searches, etc.)

Configuration and credentials

  • Node.js 18.0.0 or higher - NetSuite Account with MCP access - NetSuite AI Connector SuiteApp (Bundle ID: 522506) installed and configured - NetSuite Integration Record with OAuth 2.0 and PKCE enabled - MCP Client - Any MCP-compatible client (Claude Code, Cursor IDE, Gemini CLI, etc.)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ns_runCustomSuiteQLExecute SuiteQL queries
ns_listAllReportsList available financial reports
ns_runReportExecute a specific report
ns_listSavedSearchesList saved searches
ns_runSavedSearchExecute a saved search
ns_getRecordRetrieve a specific record
ns_createRecordCreate a new record
ns_updateRecordUpdate an existing record

How to install the Netsuite MCP Server

{
  "mcpServers": {
    "netsuite": {
      "command": "npx",
      "args": ["@suiteinsider/netsuite-mcp@latest"],
      "env": {
        "NETSUITE_ACCOUNT_ID": "your-account-id",
        "NETSUITE_CLIENT_ID": "your-client-id",
        "OAUTH_CALLBACK_PORT": "8080"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18.0.0 or higher - NetSuite Account with MCP access - NetSuite AI Connector SuiteApp (Bundle ID: 522506) installed and configured - NetSuite Integration Record with OAuth 2.0 and PKCE enabled - MCP Client - Any MCP-compatible client (Claude Code, Cursor IDE, Gemini CLI, etc.)
VariableDescriptionRequired
NETSUITE_ACCOUNT_IDConfiguration value read at startup.Optional
NETSUITE_CLIENT_IDConfiguration value read at startup.Optional
OAUTH_CALLBACK_PORTConfiguration value read at startup.Optional

Example prompts to try

  • “Use Netsuite to ns runCustomSuiteQL.”
  • “Use Netsuite to ns listAllReports.”
  • “Use Netsuite to ns runReport.”

Frequently asked questions

NetSuite MCP server with OAuth 2.0 PKCE authentication. Works seamlessly with Claude Code, Cursor IDE, and other MCP clients. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.