Skip to main content
The MongoDB tool lets an agent query and manage MongoDB collections directly.

​
Overview

MongoDB tool allows you to query and manage MongoDB NoSQL databases directly from your AI agents.

​
Installation

pip install "praisonai[tools]"

​
Environment Variables

export MONGODB_URI=mongodb://localhost:27017
export MONGODB_DATABASE=mydb

​
Quick Start

1

Simple Usage

from praisonai_tools import MongoDBTool

# Initialize
mongo = MongoDBTool(
    uri="mongodb://localhost:27017",
    database="mydb"
)

# Query
results = mongo.find("users", {"active": True})
print(results)
2

With Configuration

Use the same tool with an agent — see Usage with Agent below, or pass env vars and options from the sections above.

​
How It Works

​
Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import MongoDBTool

mongo = MongoDBTool(uri="mongodb://localhost:27017", database="mydb")

agent = Agent(
    name="DataAnalyst",
    instructions="You are a data analyst. Use MongoDB to query documents.",
    tools=[mongo]
)

response = agent.chat("Find all active users")
print(response)

​
Available Methods

​
find(collection, query, limit=10)

Find documents matching a query. 
from praisonai_tools import MongoDBTool

mongo = MongoDBTool(uri="mongodb://localhost:27017", database="mydb")
results = mongo.find("users", {"status": "active"}, limit=5)

​
insert(collection, document)

Insert a document. 
mongo.insert("users", {"name": "Alice", "email": "alice@example.com"})

​
update(collection, query, update)

Update documents. 
mongo.update("users", {"name": "Alice"}, {"$set": {"status": "inactive"}})

​
delete(collection, query)

Delete documents. 
mongo.delete("users", {"status": "inactive"})

​
list_collections()

List all collections. 
collections = mongo.list_collections()

​
Docker Setup

docker run -d --name mongodb \
    -p 27017:27017 \
    mongo:7

​
Common Errors

ErrorCauseSolution
pymongo not installedMissing dependencyRun pip install pymongo
Connection refusedMongoDB not runningStart MongoDB server
Authentication failedWrong credentialsCheck connection string

​
Best Practices

Read MONGODB_URI from the environment instead of hard-coding credentials in the connection string.
find(collection, query, limit=10) defaults to 10 documents. Keep the limit low so large collections do not flood the agent’s context.
Give the agent a database user with only the permissions it needs. Read-only credentials prevent accidental writes from generated queries.

PostgreSQL

SQL database

Redis

Key-value store

DynamoDB

AWS NoSQL