NetSuite

NetSuite

MCP server enabling natural language access to NetSuite data via SuiteQL, reports, and REST using OAuth 2.0.

2
Stars
0
Forks
0
Releases

Overview

NetSuite MCP Server is an MCP bridge that enables natural language access to NetSuite data via an OAuth 2.0 with PKCE authentication flow. It acts as an MCP server (Node.js) that connects MCP clients (Claude Code, Cursor IDE, Gemini CLI) to NetSuite's AI Connector SuiteApp. It exposes NetSuite MCP tools such as SuiteQL queries, reports, saved searches, and REST API operations, allowing users to interact with NetSuite data within their development environment using plain language queries. The server implements an OAuth manager with a local callback HTTP server (default port 8080), token storage, and automatic token refresh. Credentials can be provided via environment variables in the MCP client config, and there is support for both latest-npx deployment and local development (via npm link or direct path). It preserves session state across restarts and supports authentication resets. Prerequisites include NetSuite account access, the AI Connector SuiteApp, and an OAuth integration record. After authentication, NetSuite tools appear in MCP clients and can be used to run SuiteQL, list/execute saved searches, and generate reports through natural language prompts.

Details

Owner
dsvantien
Language
JavaScript
License
Updated
2025-12-07

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

Audience

DevelopersInteract with NetSuite data using natural language through MCP clients.
NetSuite integratorsBridge NetSuite AI Connector to MCP clients for SuiteQL, reports, saved searches.
MCP client developersEnable OAuth 2.0 PKCE authentication flow for NetSuite access in MCP apps.

Tags

NetSuiteMCPOAuth 2.0PKCESuiteQLReportsSaved SearchesREST APIAI ConnectorClaude CodeCursor IDEGemini CLIOAuth PKCEtoken refreshsession persistence