Bolt.new AI and Notion integration: Step-by-Step Guide 2025

To integrate Bolt.new with Notion, you don’t “connect Bolt to Notion” directly. Instead, you run code inside a Bolt.new workspace (backend or full‑stack project) that talks to the official Notion API using a Notion API key (also called an internal integration token). Bolt.new acts like any normal Node.js environment: you store credentials in environment variables, call Notion’s REST API, and handle the responses. The core idea is simple: Bolt.new hosts your code; your code calls Notion’s API. That’s the integration.

 

What You Actually Do

 

You create a Notion integration in Notion, get an API token, add it to your Bolt.new environment variables, then write Node.js fetch calls (or use the official SDK) to read or write Notion pages/databases. Bolt.new doesn’t have any special plugin system — it’s just a place to run API calls — so the same approach you’d use in any normal app applies here.

• Create an integration in Notion to obtain an API token.
• Share specific Notion pages/databases with your integration so it has permission to access them.
• Add the token to Bolt.new environment variables such as NOTION\_TOKEN.
• Write backend code inside Bolt.new that makes HTTPS requests to Notion’s API.

 

Step-by-step Integration Guide

 

This is the minimal real-world pattern used by senior engineers and it works the same inside Bolt.new.

 

1. Create a Notion Integration

 

• Open Notion → Settings → Connections → Develop or Manage integrations.
• Create a new internal integration.
• Copy the “Internal Integration Token”. This is your API key.

This token lets your backend code access Notion through the official API.

 

2. Share the Notion Pages/Databases with the Integration

 

• Open a Notion page or database you want your Bolt.new app to access.
• Click “Share”.
• Invite the integration you just created.

Notion does not grant access automatically. If you forget this step, your code will get “permission denied” errors.

 

3. Set Environment Variables in Bolt.new

 

In your Bolt.new project:

• Open the environment variables panel.
• Add a variable named NOTION\_TOKEN and paste your integration token.

Never hardcode the token in your code.

 

4. Write Backend Code in Bolt.new to Call Notion’s API

 

You can use the official Notion SDK or raw fetch. Both work inside Bolt.new. Below is a simple working Node.js example using fetch to read a Notion database.

 

// backend/notionClient.js

import fetch from "node-fetch"; // Ensure node-fetch is installed

const NOTION_TOKEN = process.env.NOTION_TOKEN;

// Example: Query a Notion database
export async function queryDatabase(databaseId) {
  const response = await fetch("https://api.notion.com/v1/databases/" + databaseId + "/query", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + NOTION_TOKEN,
      "Content-Type": "application/json",
      "Notion-Version": "2022-06-28" // required by Notion API
    },
    body: JSON.stringify({}) // empty query
  });

  if (!response.ok) {
    const text = await response.text();
    throw new Error("Notion API error: " + text);
  }

  return await response.json();
}

 

Then call this from your route:

 

// backend/routes.js

import express from "express";
import { queryDatabase } from "./notionClient.js";

const router = express.Router();

router.get("/notion/db/:id", async (req, res) => {
  try {
    const data = await queryDatabase(req.params.id);
    res.json(data);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

export default router;

 

5. Use the Route from Your Frontend

 

Inside Bolt.new, your frontend can call your backend like any other API:

// frontend/api.js

export async function loadNotionDatabase(databaseId) {
  const res = await fetch("/api/notion/db/" + databaseId);
  return await res.json();
}

 

6. Test in Bolt.new, Then Deploy

 

• Run the backend inside Bolt.new’s preview environment.
• Check logs for errors like missing permissions or wrong IDs.
• Once validated, you can deploy the same backend to any host (Vercel, Fly.io, etc.).

 

Key Things to Know

 

• Bolt.new does not automatically authenticate with Notion. You must use API tokens.
• You must share Notion pages with the integration or the API cannot see them.
• The Notion API is REST-based and uses JSON with mandatory "Notion-Version" headers.
• Bolt.new environment variables work like any Node.js runtime.

Once you follow these steps, your Bolt.new workspace talks to Notion exactly like any production-grade app.