MongoDB

MongoDb stores Agent sessions and run history in MongoDB.

The v1-to-v2 migration script supports MongoDB. See the migration guide.

Usage

Install the agno, pymongo, and openai packages:

uv pip install agno pymongo openai

Run MongoDB

Install Docker Desktop, then start MongoDB on port 27017:

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

Pass either db_url or db_client. The default database name is agno; set db_name to use another database.

mongodb_for_agent.py

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

db_url = "mongodb://mongoadmin:secret@localhost:27017"
db = MongoDb(db_url=db_url)

agent = Agent(db=db)

Parameters

Parameter	Type	Default	Description
`id`	`Optional[str]`	-	The ID of the database instance. UUID by default.
`db_client`	`Optional[MongoClient]`	-	The MongoDB client to use.
`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.
`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.
`learnings_collection`	`Optional[str]`	-	Name of the collection to store learnings.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Usage

Run MongoDB

Parameters

​Usage

​Run MongoDB

​Parameters

Usage

Run MongoDB

Parameters