OpenSuiteMCP NetSuite AI Assistant

An AI-powered chat assistant that integrates with NetSuite via MCP (Model Context Protocol), enabling natural language interactions with your NetSuite data. Built with Next.js, Vercel AI SDK, and supporting multiple AI providers (Google Gemini, Anthropic Claude, and OpenAI GPT).

Chat interface in dark mode showing the welcome prompt and main UI.

NetSuite MCP Tool Integration

The assistant seamlessly integrates with NetSuite's MCP tools to execute complex queries and retrieve real-time data directly from your NetSuite instance.

Example query requesting the top ten customers by sales order count, demonstrating the power of NetSuite MCP tool usage in the app.

Quick Start

Prerequisites

• Node.js 18+ and pnpm
• PostgreSQL database
• Docker (optional, for local development with SearXNG)

Setup

1. Install dependencies:

   pnpm install
   

2. Run automated setup:

   pnpm setup:backend
   

   This generates secrets, creates .env.local, and optionally starts Docker containers (PostgreSQL, Redis, and SearXNG).

3. Run database migrations:

   pnpm db:migrate
   

4. Start the development server:

   pnpm dev
   

5. Configure your API key:

   • Open the Settings modal from the sidebar

• Enter your AI provider API key (Google, Anthropic, or OpenAI)
• API keys are encrypted and stored securely in your database

The app will be running at http://localhost:3000.

Documentation

• LICENSE - Full license terms and usage restrictions
• NOTICE.md - Usage notice and commercial restrictions
• ATTRIBUTION.md - Open source attributions and credits
• CHANGELOG.md - Version history and release notes