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

You integrate Bolt.new with MongoDB Atlas the same way you integrate any Node.js backend with MongoDB: you install the official MongoDB Node.js driver or Mongoose inside the Bolt.new project, store your Atlas connection string in environment variables, and connect from your server code. Bolt.new does not provide any “built‑in” MongoDB connector — it simply runs your Node.js backend in a sandbox, so you must connect to Atlas through its standard MongoDB URI over TLS. Once the environment variable is set and the connection code is in place, you can read/write collections exactly like you would in any normal Node backend.

 

What MongoDB Atlas Integration Really Means

 

MongoDB Atlas is a fully managed database in the cloud. To talk to it, your backend must:

• Authenticate using a connection string (MongoDB URI) with a database user.
• Send queries using the official MongoDB driver (or Mongoose if you prefer an ORM-like layer).
• Be allowed by Atlas network rules (IP allowlist or set to allow all for dev).

Bolt.new is simply where your backend code runs. Nothing special or hidden: it’s a Node.js environment where you write code, and that code connects to Atlas over HTTPS/TLS.

 

Step-by-Step: Integrate Bolt.new with MongoDB Atlas

 

This is the practical flow used by full-stack developers when wiring MongoDB into Bolt.new.

• Create a MongoDB Atlas cluster
  In Atlas, create a free-tier or dedicated cluster. Then create a database user with a username/password. This user has the permissions your backend will use.
• Get your connection string
  In Atlas, click Connect → Drivers. Copy the connection URI that looks like:
  mongodb+srv://USERNAME:[email protected]/myDatabase?retryWrites=true&w=majority
• Configure network access
  For development inside Bolt.new, you can temporarily set your Atlas Network Access to allow all IPs: 0.0.0.0/0.
  This allows the Bolt sandbox to reach Atlas. For production, restrict it to trusted IPs/VPCs.
• Open your Bolt.new project and set environment variables
  In Bolt, add an environment variable:
  MONGODB\_URI = mongodb+srv://...your full URI...
• Install the MongoDB driver (or Mongoose)

npm install mongodb

If you prefer Mongoose:

npm install mongoose

• Write backend connection code
  Here’s the simplest working example using the official driver:

// db.js
// Standard MongoDB Node.js driver connection
import { MongoClient } from "mongodb";

const client = new MongoClient(process.env.MONGODB_URI);

export async function connectToDB() {
  if (!client.topology || !client.topology.isConnected()) {
    await client.connect(); // Establish connection
  }
  return client.db("myDatabase"); // Replace with your database name
}

Example usage inside an API route (Express-style or Bolt’s Node server):

// routes/example.js
import { connectToDB } from "./db.js";

export async function handler(req, res) {
  const db = await connectToDB();
  const items = await db.collection("items").find({}).toArray();
  res.json(items);
}

• If using Mongoose (some people prefer schema-based models):

// db.js
import mongoose from "mongoose";

export async function connectToDB() {
  if (mongoose.connection.readyState === 0) {
    await mongoose.connect(process.env.MONGODB_URI); // Mongoose handles pooling
  }
}

Example model:

// models/Todo.js
import mongoose from "mongoose";

const todoSchema = new mongoose.Schema({
  text: String,
  done: Boolean
});

export const Todo = mongoose.model("Todo", todoSchema);

Example route:

// routes/todos.js
import { connectToDB } from "../db.js";
import { Todo } from "../models/Todo.js";

export async function handler(req, res) {
  await connectToDB();
  const all = await Todo.find();
  res.json(all);
}

 

Important Operational Notes

 

• Bolt sandboxes do not persist files like a server — but database data in Atlas is persistent because it lives outside Bolt.
• Never hardcode your MongoDB URI. Always use environment variables.
• Atlas network access must allow Bolt outbound connections or your app won’t connect.
• Connection pooling is handled automatically by the MongoDB driver and by Mongoose after the first connection call.

 

End Result

 

Once this is wired up, your Bolt.new backend behaves like any Node.js server connected to MongoDB Atlas. You can create users, store app data, run auth workflows, or power dashboards — all backed by a real cloud database with TLS, backups, and scaling built in.