@neondatabase/toolkit

This is a toolkit that Bundles Neon's API Client as well as Neon's Serverless Driver.

You can use it to simplify the process of creating a Neon project and running SQL queries. This is ideal for test environments, where you don't want to set up a Neon project manually.

Furthermore, it's also a great choice for AI agents which need to interact with Neon.

[!CAUTION] This is in very early development and API stability is not guaranteed.

1import { NeonToolkit } from "@neondatabase/toolkit";
2
3const toolkit = new NeonToolkit(process.env.NEON_API_KEY!);
4const project = await toolkit.createProject();
5
6await toolkit.sql(
7  project,
8  `
9    CREATE TABLE IF NOT EXISTS users (
10      id UUID PRIMARY KEY,
11      name VARCHAR(255) NOT NULL
12    );
13  `,
14);
15
16await toolkit.sql(
17  project,
18  `INSERT INTO users (id, name) VALUES (gen_random_uuid(), 'Sam Smith')`,
19);
20
21console.log(
22  await toolkit.sql(
23    project,
24    `SELECT name FROM users`,
25  ),
26);
27
28await toolkit.deleteProject(project);

To run this:

1NEON_API_KEY=<YOUR_NEON_API_KEY> node index.js # bun also works

Accessing the API Client

1import { NeonToolkit } from "@neondatabase/toolkit";
2
3const toolkit = new NeonToolkit(process.env.NEON_API_KEY!);
4
5const project = await toolkit.createProject();
6
7const apiClient = toolkit.apiClient;
8
9// Now, you have the underlying API client which lets you interact with Neon's API.

Security

Neon adheres to the securitytxt.org standard for transparent and efficient security reporting. For details on how to report potential vulnerabilities, please visit our Security reporting page or refer to our security.txt file.

If you have any questions about our security protocols or would like a deeper dive into any aspect, our team is here to help. You can reach us at security@neon.tech.