Skip to main content
Glama
cafeasp
by cafeasp

@cafeasp/netsuite-tools

A TypeScript toolkit for NetSuite developers — CLI and MCP server powered by a shared core library.

Terminal → CLI (Commander.js) ──┐
                                ├──► Core Library (Auth + API) ──► NetSuite REST API
Claude/AI → MCP Server (stdio) ─┘

Packages

Package

Description

npm

@cafeasp/netsuite-core

Auth, REST API client, SuiteQL engine

npm

@cafeasp/netsuite-cli

Terminal interface

npm

@cafeasp/netsuite-mcp

MCP server for AI clients

npm

Related MCP server: QuickBooks Online MCP Server

Quick Start

CLI

npm install -g @cafeasp/netsuite-cli

# Configure credentials
netsuite config init

# Test connection
netsuite info

# Query data
netsuite query "SELECT id, companyname FROM customer" --limit 10

# Get a record
netsuite record get customer 123 --format json

# List records
netsuite record list item --limit 20

MCP Server (Claude Code)

npm install -g @cafeasp/netsuite-mcp

claude mcp add netsuite-mcp -e NETSUITE_ACCOUNT_ID=YOUR_ID -e NETSUITE_CONSUMER_KEY=YOUR_KEY -e NETSUITE_CONSUMER_SECRET=YOUR_SECRET -e NETSUITE_TOKEN_ID=YOUR_TOKEN -e NETSUITE_TOKEN_SECRET=YOUR_SECRET -e NETSUITE_AUTH_METHOD=tba -- netsuite-mcp

Then in Claude Code:

  • "Show me the first 5 customers in NetSuite"

  • "What fields are available on the salesorder record?"

  • "Run this SuiteQL: SELECT id, tranid FROM transaction WHERE type = 'SalesOrd'"

Core Library

npm install @cafeasp/netsuite-core
import {
  loadConfig,
  createAuthProvider,
  NetSuiteClient,
  SuiteQLClient,
} from "@cafeasp/netsuite-core";

const config = loadConfig();
const auth = createAuthProvider(config);
const client = new NetSuiteClient(auth, config.accountId);
const suiteql = new SuiteQLClient(client);

const result = await suiteql.query("SELECT id, companyname FROM customer", { limit: 10 });
console.log(result.items);

Authentication

The tool uses Token-Based Authentication (TBA) — the most common auth method for NetSuite developers.

You need four values from your NetSuite account:

  1. Consumer Key and Consumer Secret (from an Integration Record)

  2. Token ID and Token Secret (from an Access Token)

See each package's README for detailed setup instructions.

Configuration

Credentials are stored in ~/.netsuite/config.json with named profiles:

# Set up default profile
netsuite config init

# Use a specific profile
netsuite --profile sandbox query "SELECT 1 FROM dual"

Environment variables override file config:

  • NETSUITE_ACCOUNT_ID

  • NETSUITE_CONSUMER_KEY

  • NETSUITE_CONSUMER_SECRET

  • NETSUITE_TOKEN_ID

  • NETSUITE_TOKEN_SECRET

Requirements

  • Node.js >= 18

  • NetSuite account with REST Web Services and TBA enabled

License

MIT

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    Not graded
    maintenance
    Enables AI assistants to securely connect to Snowflake data warehouses and execute SQL queries through natural language interactions. Supports multiple authentication methods and provides formatted query results with built-in security controls.
    1
    2
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to query and manage QuickBooks Online data through natural language, including customers, invoices, bills, vendors, accounts, and financial reports.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides a single MCP endpoint for AI clients to operate NetSuite via a dedicated integration identity, supporting read, write, and action tools with risk policies and audit logging.
    4,621
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Secure Docusign Navigator integration for AI assistants to access and analyze agreement data.

  • Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

  • Provide AI assistants with real-time access to official SEC EDGAR filings and financial data. Enab…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cafeasp/cafeasp-netsuite-cli-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server