dsvantien/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)
**Note**: we dont need client secret (since this is public client and Authorization Code Grant with pkce)
2. MCP Client Configuration
Add to your MCP client's configuration file:
**Claude Code**: ~/.claude.json
**Cursor IDE**: .cursor/mcp.json
**Gemini CLI**: Per Gemini's MCP setup
Option A: Using npx (Recommended - No Installation Required)
**Benefits**:
- No manual installation required
- Always uses the latest version with @latest
- Clean, simple configuration
- Works immediately after MCP client restart
**Optional Environment Variables**:
- OAUTH_CALLBACK_PORT - OAuth callback port (default: 8080)
Option B: Local Development Setup
For contributing or local development:
Then configure with absolute path:
Option C: Without Environment Variables
**Note**: You'll need to provide credentials when calling netsuite_authenticate