MongoDB

Query and manage MongoDB databases

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

Best Practices

Related Tools