MongoDB Integration

Connecting MongoDB to Retool

Connecting to MongoDB

Retool supports connecting to both managed and self-hosted MongoDB databases including MongoDB Atlas and AWS DocumentDB.

Configuring a MongoDB resource in Retool

Connecting to MongoDB Atlas

You'll need to get a connection string for connecting to your cluster in the Atlas UI by going through the cluster connect flow. Note the placeholder database name myFirstDatabase in the example below: it needs to be updated to point to a real collection name in your cluster.

Connection string highlighted here. You can find it in the connect flow

To connect Retool to the MongoDB cluster above, specify host with the DNS seed list connection format. Your database name is the name of the collection you want to query. Make sure you've provisioned database and network access first!


Picking a connection format

Retool supports MongoDB's standard connection format (mongo://) as well as the new seed list connection format (mongodb+srv://). If you're using a managed offering such as MongoDB Atlas, the seed list connection format may be preferred.


Whitelisting Retool's IP

If you're using a managed MongoDB database such as MongoDB Atlas, you'll need to add the Retool app to your IP access list. If you're using the cloud version of Retool, the IP address is

Querying MongoDB

Supported methods

Retool supports the following MongoDB methods:

  • find
  • findOne
  • findOneAndUpdate
  • count
  • distinct
  • aggregate
  • insertOne
  • updateOne
  • deleteOne
  • insertMany
  • updateMany
  • deleteMany
  • listCollections

Basic Queries

Write MongoDB queries from Retool's editor interface. Select the method to query your database with, the collection you want to use the query with, and you're good to go.

Below is an example of querying a MongoDB database for companies where name = 'Uber'


We don't support MongoDB's classic syntax

Instead we support MongoDB's Extended JSON syntax. For more information see

Here's an example of using MongoDB's Extended JSON Syntax to query based on an ObjectId

See below for some simple equivalencies from the normal MongoDB syntax and the Extended JSON Syntax. In Retool, use the Extended JSON Syntax.

// ObjectIds
// supported: Extended JSON syntax
{ _id: { $oid: '5b3ddc6dd2ab742125322cf3' } }
// not supported: MongoDB classic syntax
{ _id: ObjectId('5b3ddc6dd2ab742125322cf3') }

// Dates 
// supported: Extended JSON syntax
{ createdAt: { $date: '2018-08-31T05:26:05+00:00'} }
// not supported: MongoDB classic syntax
{ createdAt: new Date('2018-08-31T05:26:05+00:00') }

Dynamic Queries

Just like any other datasource in Retool, you can also refer to dynamic variables inside your MongoDB Queries. Here's an example of searching a MongoDB database based on a value of a textinput:


A walkthrough tutorial for working with MongoDB in Retool

If you're working with MongoDB data in Retool, we put together a walkthrough guide to help get your Atlas setup connected and build a sample listing approval tool using Mongo's sample_airbnb dataset. Check it out here!

Updated about 14 hours ago

MongoDB Integration

Connecting MongoDB to Retool

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.