DocsUseful Tools

Useful Tools

Pre-built tools from connectonion.useful_tools

Quick Usage

main.py
python
from connectonion import Agent
from connectonion.useful_tools import gmail, memory, web_fetch

agent = Agent(
    "assistant",
    tools=[gmail.search, gmail.send, memory.remember, web_fetch.fetch]
)

agent.input("Search my emails for invoices from last week")

Email

Send and receive emails through various providers

Gmail

Full Gmail integration with OAuth

Outlook

Microsoft 365 email integration

Agent Emails

Generic SMTP/IMAP email

Calendar

Schedule meetings and manage calendars

Google Calendar

Google Calendar integration

Microsoft Calendar

Outlook Calendar integration

Memory & Storage

Persistent memory and knowledge storage

Memory

RAG-powered persistent memory

Web

Fetch and interact with web content

WebFetch

Fetch and parse web pages

System

System and terminal operations

Shell

Execute shell commands

Terminal

Interactive terminal sessions

Productivity

Task management and productivity tools

Todo List

Task management for agents

Developer

Development and code tools

FileTools

Read/edit files with safety tracking

Diff Writer

Write code diffs

Slash Command

Custom CLI commands

Customizing Built-in Tools

Need to modify a built-in tool? Copy it to your project:

code

bash

# Copy a tool to your project
co copy shell

# Copy multiple tools
co copy shell memory gmail

output

✓ Copied: ./tools/shell.py

✓ Copied: ./tools/memory.py

✓ Copied: ./tools/gmail.py

Then import from your local copy and customize:

main.py
python
# Before (from package)
from connectonion import Shell

# After (from your copy)
from tools.shell import Shell  # Customize freely!

See co copy for full details.

Building Custom Tools

Any Python function can be a tool. Just pass it to the Agent:

main.py
python
def my_custom_tool(query: str) -> str:
    """Search my database for relevant information."""
    return database.search(query)

agent = Agent("assistant", tools=[my_custom_tool])