Docs Menu

Docs HomeMongoDB Shell

MongoDB Shell (mongosh)

On this page

  • Download and Install mongosh
  • Connect to a MongoDB Deployment
  • The MongoDB Shell versus the Legacy mongo Shell
  • Learn More

The MongoDB Shell, mongosh, is a fully functional JavaScript and Node.js 16.x REPL environment for interacting with MongoDB deployments. You can use the MongoDB Shell to test queries and operations directly with your database.

mongosh is available as a standalone package in the MongoDB Download Center.

To learn how to download and install the mongosh binary, see Install mongosh.

Once you have installed the MongoDB Shell and added it to your system PATH, you can connect to a MongoDB deployment. To learn more, see Connect to a Deployment.

The legacy mongo shell was deprecated in MongoDB 5.0 and removed in MongoDB 6.0. The new MongoDB Shell, mongosh, offers numerous advantages over the legacy shell. The new shell has improved:

  • compatibility with the MongoDB Node.js driver

  • syntax highlighting

  • command history

  • logging

Some legacy methods are unavailable or have been replaced with updated methods in mongosh. To maintain backwards compatibility, the legacy methods that mongosh supports use the same syntax as the corresponding methods in the mongo shell.

To see the complete list of methods supported by mongosh, refer to: MongoDB Shell Methods.

Install mongosh →
Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.