Mongo Go Driver

The Official Golang driver for MongoDB
Alternatives To Mongo Go Driver
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Mongo24,735120 hours ago26October 09, 202279otherC++
The MongoDB Database
Migrate12,8541,0276 days ago132June 11, 2023315otherGo
Database migrations. CLI and Golang library.
Node Mongodb Native9,882116,99511,46820 hours ago439November 16, 202322apache-2.0TypeScript
The Official MongoDB Node.js Driver
Mongo Go Driver7,7297,06720 hours ago333November 08, 202311apache-2.0Go
The Official Golang driver for MongoDB
Mongo Python Driver3,96817,9312,2462 days ago136November 29, 202312apache-2.0Python
PyMongo - the Official MongoDB Python driver
Mongo Csharp Driver3,0682,1853,105a day ago88October 09, 202353apache-2.0C#
The Official C# .NET Driver for MongoDB
Mgo2,6192,1022,2463 years ago5August 16, 2019224otherGo
The MongoDB driver for Go. UNMAINTAINED - SEE BELOW
Mongo Java Driver2,57911,4031,08121 hours ago146June 07, 202318apache-2.0Java
The official MongoDB drivers for Java, Kotlin, and Scala
Phpfastcache2,3072091363 months ago187February 18, 20231mitPHP
A high-performance backend cache system. It is intended for use in speeding up dynamic web applications by alleviating database load. Well implemented, it can drops the database load to almost nothing, yielding faster page load times for users, better resource utilization. It is simple yet powerful.
Awesome Mongodb2,259
2 months ago2
:leaves: A curated list of awesome MongoDB resources, libraries, tools and applications
Alternatives To Mongo Go Driver
Select To Compare

Alternative Project Comparisons

docs docs

MongoDB Go Driver

The MongoDB supported driver for Go.


  • Go 1.18 or higher. We aim to support the latest versions of Go.
  • Go 1.20 or higher is required to run the driver test suite.
  • MongoDB 3.6 and higher.


The recommended way to get started using the MongoDB Go driver is by using Go modules to install the dependency in your project. This can be done either by importing packages from and having the build step install the dependency or by explicitly running

go get

When using a version of Go that does not support modules, the driver can be installed using dep by running

dep ensure -add ""


To get started with the driver, import the mongo package and create a mongo.Client with the Connect function:

import (


ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
client, err := mongo.Connect(options.Client().ApplyURI("mongodb://localhost:27017"))

Make sure to defer a call to Disconnect after instantiating your client:

defer func() {
    if err = client.Disconnect(ctx); err != nil {

For more advanced configuration and authentication, see the documentation for mongo.Connect.

Calling Connect does not block for server discovery. If you wish to know if a MongoDB server has been found and connected to, use the Ping method:

ctx, cancel = context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
err = client.Ping(ctx, readpref.Primary())

To insert a document into a collection, first retrieve a Database and then Collection instance from the Client:

collection := client.Database("testing").Collection("numbers")

The Collection instance can then be used to insert documents:

ctx, cancel = context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
res, err := collection.InsertOne(ctx, bson.D{{"name", "pi"}, {"value", 3.14159}})
id := res.InsertedID

To use bson.D, you will need to add "" to your imports.

Your import statement should now look like this:

import (


Several query methods return a cursor, which can be used like this:

ctx, cancel = context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
cur, err := collection.Find(ctx, bson.D{})
if err != nil { log.Fatal(err) }
defer cur.Close(ctx)
for cur.Next(ctx) {
    var result bson.D
    err := cur.Decode(&result)
    if err != nil { log.Fatal(err) }
    // do something with result....
if err := cur.Err(); err != nil {

For methods that return a single item, a SingleResult instance is returned:

var result struct {
    Value float64
filter := bson.D{{"name", "pi"}}
ctx, cancel = context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
err = collection.FindOne(ctx, filter).Decode(&result)
if err == mongo.ErrNoDocuments {
    // Do something when no record was found
    fmt.Println("record does not exist")
} else if err != nil {
// Do something with result...

Additional examples and documentation can be found under the examples directory and on the MongoDB Documentation website.

Network Compression

Network compression will reduce bandwidth requirements between MongoDB and the application.

The Go Driver supports the following compression algorithms:

  1. Snappy (snappy): available in MongoDB 3.4 and later.
  2. Zlib (zlib): available in MongoDB 3.6 and later.
  3. Zstandard (zstd): available in MongoDB 4.2 and later.

Specify Compression Algorithms

Compression can be enabled using the compressors parameter on the connection string or by using ClientOptions.SetCompressors:

opts := options.Client().ApplyURI("mongodb://localhost:27017/?compressors=snappy,zlib,zstd")
client, _ := mongo.Connect(opts)
opts := options.Client().SetCompressors([]string{"snappy", "zlib", "zstd"})
client, _ := mongo.Connect(opts)

If compressors are set, the Go Driver negotiates with the server to select the first common compressor. For server configuration and defaults, refer to networkMessageCompressors.

Messages compress when both parties enable network compression; otherwise, messages remain uncompressed


For help with the driver, please post in the MongoDB Community Forums.

New features and bugs can be reported on jira:


Check out the project page for tickets that need completing. See our contribution guidelines for details.

Continuous Integration

Commits to master are run automatically on evergreen.

Frequently Encountered Issues

See our common issues documentation for troubleshooting frequently encountered issues.

Thanks and Acknowledgement


The MongoDB Go Driver is licensed under the Apache License.

Popular Mongodb Projects
Popular Driver Projects
Popular Data Storage Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Golang Library