matimo-cli

Command-line interface for Matimo - tool package manager & MCP server launcher.

Installation

pip install matimo-cli
# or with uv
uv add matimo-cli

Commands

matimo install - Install provider packages

matimo install slack github gmail         # install specific providers

matimo list - List available tools

matimo list                               # all loaded tools

matimo search - Search for tools

matimo search email                       # text search over tool names + descriptions
matimo search "send message"

matimo mcp - Start MCP server

Serve all loaded tools over the Model Context Protocol so Claude Desktop, Cursor, or any MCP client can access them.

matimo mcp                                # start on stdio (default)
matimo mcp --transport http --port 3000   # start as HTTP server

Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "matimo": {
      "command": "matimo",
      "args": ["mcp"]
    }
  }
}

matimo doctor - Diagnose your setup

matimo doctor                             # check config, installed providers, connectivity

matimo review - Review agent-created tool definitions

Operates on the current directory (or $MATIMO_TOOL_DIR), not an arbitrary path argument:

matimo review list                        # list approved tools and HITL-pending ones
matimo review approve my_tool             # approve a pending tool
matimo review reject my_tool              # reject/revoke a tool

review works on one directory that holds both the agent-created tools (<dir>/<tool>/definition.yaml) and the approval manifest (<dir>/.matimo-approvals.json): the current directory, or MATIMO_TOOL_DIR. For your app to see a CLI approval:

• set approvalDir (approval_dir) in the app to that same directory, and
• use the same MATIMO_APPROVAL_SECRET in the CLI and the app (approve refuses to run without it).

approve sets status: approved in the YAML and signs it; reload the app's tools afterwards. list shows the tools the manifest records as approved, and those held as pending by HITL quarantine on reload. Inside a running agent, matimo_approve_tool does the same job with the app's own manifest.

Configuration

The CLI reads configuration entirely from environment variables - there is no .matimo.yaml config file:

export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
export MATIMO_LOG_FORMAT=json       # json | simple
export MATIMO_APPROVED_PATTERNS="get_*,list_*"  # tools that never ask for approval

Documentation

• CLI Guide
• MCP Guide
• Getting Started

Links

• PyPI: https://pypi.org/project/matimo-cli/
• Docs: https://docs.matimo.dev/
• GitHub: https://github.com/tallclub/matimo