Skip to main content

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

from praisonai_tools import MongoDBTool

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

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

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": "[email protected]"})

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