NetSuite MCP Server

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.

Motivation and Context

NetSuite provides an official AI Connector SuiteApp that enables AI-powered interactions with NetSuite data. However, NetSuite’s AI Connector currently only supports:

• Claude via Anthropic’s web interface
• ChatGPT via custom GPT connections The problem: Developers using MCP-compatible tools like Claude Code, Cursor IDE, Windsurf, or other CLI/IDE environments cannot leverage NetSuite’s AI capabilities because there’s no MCP server implementation.

This MCP server solves that gap by:

• Providing the missing bridge between MCP clients (Claude Code, Cursor, Gemini CLI, etc.) and NetSuite’s AI Connector
• Enabling the exact same functionality that NetSuite’s AI Connector provides, but accessible through any MCP-compatible client
• Allowing developers to interact with NetSuite data using natural language directly within their development environment
• Maintaining the same security standards (OAuth 2.0 with PKCE) required by NetSuite’s official AI Connector

In essence, this MCP server brings NetSuite’s AI capabilities to the broader MCP ecosystem, allowing developers to query business data, generate reports, and automate NetSuite operations without leaving their IDE or CLI.

Features

• ✅ 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.)
• ✅ Modular Architecture - Clean, maintainable codebase following single-responsibility principle

Quick Start

1. NetSuite Setup

Step 1: Install NetSuite AI Connector SuiteApp

Before creating the integration record, you must install and configure the NetSuite AI Connector SuiteApp:

Important: The NetSuite AI Connector SuiteApp is required for MCP functionality. Without it, the MCP tools will not be available even after authentication.

Step 2: Create OAuth Integration Record

After installing the SuiteApp, create an integration record:

1. Navigate to Setup > Integration > Manage Integrations > New
2. Fill in the details:
   • Name: “MCP Server Integration”
   • OAuth 2.0: Checked Authorization Code Grant Checked Public Client
   • Redirect URI: http://localhost:8080/callback (or your custom port)
3. Save and copy the Client ID (consumer key)