netsuite

This project is officially listed on the https://github.com/modelcontextprotocol/servers , which showcases community-built and verified MCP servers.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio dsvantien-netsuite-mcp-server npx @suiteinsider/netsuite-mcp@latest \
  --env NETSUITE_CLIENT_ID="your-client-id" \
  --env NETSUITE_ACCOUNT_ID="your-account-id" \
  --env OAUTH_CALLBACK_PORT="8080"

How to use

This MCP server provides a bridge from any MCP-compatible client (such as Claude Code, Cursor IDE, or Gemini CLI) to NetSuite's AI Connector capabilities using OAuth 2.0 with PKCE. Once authenticated, you gain access to NetSuite MCP tools that let you run SuiteQL queries, generate or run saved searches, and produce standard or custom reports via natural language prompts. The server handles the OAuth flow, token refresh, and session persistence so you can focus on querying data and generating insights within your development environment. After authentication, you can issue natural language commands like asking for customer lists, retrieving recent sales orders, or executing predefined reports, all routed through the MCP client to NetSuite.

How to install

Prerequisites:

Node.js (LTS) and npm installed on your machine
Access to NetSuite account with an OAuth 2.0 integration (PKCE) configured

Installation steps:

Ensure Node.js and npm are installed
- Check versions: node -v and npm -v
Install the MCP server package (recommended via npx as shown in the config):
- No global install required if using npx as in the configuration
If you want local development or contributions:
- Clone the repository and install dependencies: git clone https://github.com/dsvantien/netsuite-mcp-server.git cd netsuite-mcp-server npm install
- Run or link locally for testing: npm run start
Prepare your MCP client configuration (Claude Code, Cursor IDE, or Gemini CLI) to point at the netsuite server as defined in the mcp_config example, including the required environment variables (NETSUITE_ACCOUNT_ID, NETSUITE_CLIENT_ID, OAUTH_CALLBACK_PORT).

Notes:

Ensure the OAuth callback port (default 8080) is accessible from your environment
You may need to restart your MCP client after authenticating to pick up NetSuite tools

Additional notes

Tips and common issues:

Ensure NETSUITE_ACCOUNT_ID and NETSUITE_CLIENT_ID are correct and correspond to your NetSuite OAuth integration. The client secret is not required for PKCE public clients.
If you don’t see NetSuite tools after authentication, restart your MCP client to refresh the toolset visibility.
The OAUTH_CALLBACK_PORT env var controls the local port where the OAuth callback is received; update it if you run on a non-default port.
Session persistence is enabled to survive server restarts; however, if tokens are revoked or expired and not refreshed, you may need to re-authenticate.
When using npx, your environment must have network access to fetch the latest package; using @latest ensures you always get the newest version.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.