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": "[e-mail]"})

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

Error	Cause	Solution
pymongo not installed	Missing dependency	Run pip install pymongo
Connection refused	MongoDB not running	Start MongoDB server
Authentication failed	Wrong credentials	Check connection string

Best Practices

Load the connection URI from the environment

Read MONGODB_URI from the environment instead of hard-coding credentials in the connection string.

Cap query results

find(collection, query, limit=10) defaults to 10 documents. Keep the limit low so large collections do not flood the agent’s context.

Scope agent access

Give the agent a database user with only the permissions it needs. Read-only credentials prevent accidental writes from generated queries.

Related Tools

PostgreSQL

SQL database

Redis

Key-value store

DynamoDB

AWS NoSQL