Async MongoDB

Use MongoDB asynchronously for agent session storage.

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.