Skip to main content
Version: 2.2.0

MongoDB

ToolJet can connect to MongoDB to read and write data.

Connection

Please make sure the host/ip of the database is accessible from your VPC if you have self-hosted ToolJet. If you are using ToolJet cloud, please whitelist our IP.

To add a new MongoDB, click on the + button on data sources panel at the left-bottom corner of the app editor. Select MongoDB from the modal that pops up.

ToolJet requires the following to connect to your MongoDB.

  • Host
  • Port
  • Username
  • Password

It is recommended to create a new MongoDB user so that you can control the access levels of ToolJet.

ToolJet - Mongo connection

Click on 'Test connection' button to verify if the credentials are correct and that the database is accessible to ToolJet server. Click on 'Save' button to save the data source.

Querying MongoDB

Click on + button of the query manager at the bottom panel of the editor and select the database added in the previous step as the data source. Select the operation that you want to perform and click 'Save' to save the query.

ToolJet - Mongo query

Click on the 'run' button to run the query. NOTE: Query should be saved before running.

tip

Query results can be transformed using transformations. Read our transformations documentation to see how: link

Supported operations

List Collections

Returns list of collections

Fine One

Return a document which satisfy the given filter and options. Reference

Fine Many

Return list of documents which satisfy the given filter and options. Reference

Total Count

Returns an estimation of the number of documents in the collection based on collection metadata. Reference

Count

Returns the number of documents based on the filter. Reference

Distinct

Retrieve a list of distinct values for a field based on the filter. Reference

Insert One

Insert a document. Reference

Insert Many

Insert list of documents. Reference

Update One

Update a document based on the filter. Reference

Update Many

Update many documents based on the filter. Reference

Replace One

Replace a document based on filter. Reference

Find One and Update

If your application requires the document after updating, use this instead of Update One. Reference

Find One and Replace

If your application requires the document after updating, use this instead of Replace One. Reference

Find One and Delete

If your application requires the document after deleting, use this instead of Delete One. Reference

Aggregate

Aggregation operations are expressions you can use to produce reduced and summarized results. Reference

Delete One

Delete a record based on the filter. Reference

Delete Many

Delete many records based on the filter. Reference

Bulk Operations

Perform bulk operations. Reference

Dynamic Quries

{ amount: { $lt: '{{ components.textinput1.value }}' }}

// Dates
// supported: Extended JSON syntax
{ createdAt: { $date: '{{ new Date('01/10/2020') }}'} }
// not supported: MongoDB classic syntax
{ createdAt: new Date('01/10/2020') }

Reference on mongodb extended JSON supported data types