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 install slack --upgrade            # upgrade an existing provider

matimo list — List available tools

matimo list                               # all loaded tools
matimo list --provider slack             # filter by provider
matimo list --format json                # JSON output

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
matimo mcp --name "my-agent"              # set server name

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 doctor --fix                       # attempt auto-repair

matimo review — Review agent-created tool definitions

matimo review ./agent-tools/              # interactive review of draft tools

Configuration

The CLI reads Matimo configuration from the environment or a .matimo.yaml file in the project root:

# .matimo.yaml
toolPaths:
  - ./tools
  - ./agent-tools
logLevel: info

Environment variables:

export MATIMO_LOG_LEVEL=info        # silent | error | warn | info | debug
export MATIMO_LOG_FORMAT=json       # json | simple
export MATIMO_AUTO_APPROVE=true     # auto-approve tool approval prompts (CI/CD)

Documentation

• CLI Guide
• MCP Guide
• Getting Started

Links

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