Tools & Toolsets

Mona comes with a rich set of built-in tools she can invoke during conversations. Tools are grouped into toolsets that can be enabled or disabled per platform.

Built-in tools

Tool	What it does
`terminal`	Execute shell commands (local, Docker, SSH, or cloud)
`file_read`	Read files and directories
`file_write`	Create or overwrite files
`file_edit`	Apply structured edits to files
`web_search`	Search the web (Exa, Firecrawl, Parallel Web)
`browser`	Browse and scrape web pages via Playwright
`vision`	Analyze images
`image_generate`	Generate images via Fal or other providers
`tts`	Convert text to speech (Edge TTS, ElevenLabs)
`stt`	Transcribe audio (faster-whisper)
`git`	Run git commands and analyze diffs
`code_execution`	Execute Python scripts with tool access

Toolsets

Toolsets are collections of tools that can be toggled together:

monoclaw tools enable core      # File I/O, terminal, git
monoclaw tools enable web       # Search, browser, vision
monoclaw tools enable voice     # TTS, STT
monoclaw tools disable browser  # Disable a specific tool

Platform-specific toolsets

You can configure different tools for different platforms:

# ~/.monoclaw/config.yaml
toolsets:
  cli:
    - core
    - web
    - voice
  telegram:
    - core
    - web
  discord:
    - core
    - web
    - voice

Terminal backends

The terminal tool supports multiple backends for isolation:

Backend	Isolation	Best for
`local`	None	Trusted environments, speed
`docker`	Container	General safety, reproducibility
`ssh`	Remote machine	Cloud VMs, dedicated servers
`daytona`	Cloud sandbox	Ephemeral, serverless
`modal`	Cloud sandbox	GPU workloads, scaling

Configure the default backend:

monoclaw config set terminal.backend docker

Custom tools

You can add custom tools via:

Plugins — Python packages that register new tools
MCP servers — External tool servers via Model Context Protocol
Skills — Markdown-based knowledge that teaches Mona new workflows

See the Plugins and MCP guides for details.