Connect to MongoDB databases from Airplane runbooks.
The MongoDB resource allows tasks and runbooks to connect to a MongoDB database. For a high-level introduction to resources, see the resources page.

Creating a MongoDB resource

To create a new MongoDB resource, visit resources for your team, click the "New" button, and select the MongoDB resource type. Enter your connection details in the form:
Name should be a human-readable name for your resource.
Connection string should be the full connection string for your MongoDB database. This typically looks something like:
Be sure to include your username and password. The connection string is stored encrypted at rest and won't be displayed back to users.

Accessing from runbooks

You can use MongoDB resources with runbooks by adding a MongoDB block. You can run commands like find and insertMany directly from the runbook. See Integration blocks for details.

IP whitelisting

If your database has restrictions on incoming network connections, you'll need to ensure the Airplane IP addresses are whitelisted:

Private networking

To connect to a database inside a private VPC, you can self-host the agent and run the agent within your own VPC. Since tasks and MongoDB commands run on agents, these tasks will run from within your network and be able to connect.

Field reference

When this resource is attached to a task, its fields are available in the JSON environment variable AIRPLANE_RESOURCES under the alias it was attached with. The available fields are documented below.

The ID of the resource.


The slug of the resource as defined in the resource settings page.


The name of the resource.

kindstring(value: mongodb)

The kind of the resource.

The MongoDB connection string.