Async MongoDB

Agno supports using MongoDB asynchronously, with the AsyncMongoDb class.

v2 Migration Support: If you’re upgrading from Agno v1, MongoDB is fully supported in the v2 migration script. See the migration guide for details.

Usage

Install the pymongo (4.9 or later, for the async client) and openai packages:

uv pip install "pymongo>=4.9" openai

motor clients are also supported, but motor is deprecated. Use PyMongo’s async client instead.

async_mongodb_for_agent.py

from agno.agent import Agent
from agno.db.mongo import AsyncMongoDb

# MongoDB connection settings
db_url = "mongodb://mongoadmin:secret@localhost:27017"

db = AsyncMongoDb(db_url=db_url)

# Setup your Agent with the Database
agent = Agent(db=db)

Run MongoDB

Install docker desktop and run MongoDB on port 27017 using:

docker run -d \
  --name local-mongo \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=mongoadmin \
  -e MONGO_INITDB_ROOT_PASSWORD=secret \
  mongo

Params

Parameter	Type	Default	Description
`id`	`Optional[str]`	-	The ID of the database instance. UUID by default.
`db_client`	`Optional[Union[AsyncIOMotorClient, AsyncMongoClient]]`	-	The MongoDB async client to use. Supports Motor and PyMongo async clients.
`db_name`	`Optional[str]`	-	The name of the database to use.
`db_url`	`Optional[str]`	-	The database URL to connect to.
`session_collection`	`Optional[str]`	-	Name of the collection to store sessions.
`memory_collection`	`Optional[str]`	-	Name of the collection to store memories.
`metrics_collection`	`Optional[str]`	-	Name of the collection to store metrics.
`eval_collection`	`Optional[str]`	-	Name of the collection to store evaluation runs.
`knowledge_collection`	`Optional[str]`	-	Name of the collection to store knowledge documents.
`culture_collection`	`Optional[str]`	-	Name of the collection to store cultural knowledge.
`traces_collection`	`Optional[str]`	-	Name of the collection to store traces.
`spans_collection`	`Optional[str]`	-	Name of the collection to store spans.
`learnings_collection`	`Optional[str]`	-	Name of the collection to store learnings.
`schedules_collection`	`Optional[str]`	-	Name of the collection to store cron schedules.
`schedule_runs_collection`	`Optional[str]`	-	Name of the collection to store schedule run history.

​Usage

​Run MongoDB

​Params

Usage

Run MongoDB

Params