Maton MCP Tools

Maton AI

Connect your AI agent to SaaS tools via Maton's OAuth connection management. This skill provides:

Overview

Maton provides a unified API for connecting to SaaS tools via OAuth. Once connected, you can interact with these tools through Maton's AI capabilities or directly via their API.

Prerequisites

1. Maton Account — Sign up at maton.ai 2. API Key — Get your API key from the Maton dashboard 3. Clawdbot Gateway — v2026.1.0 or later with UI enabled

Quick Start

Step 1: Get Your API Key

1. Go to maton.ai and sign in 2. Navigate to Settings → API Keys 3. Create or copy your API key

Step 2: Configure in Clawdbot UI

Option A: Via API Keys tab 1. Open Clawdbot Dashboard → Settings → API Keys 2. Find "Maton" in the Environment Keys section 3. Enter your API key and click Save

Option B: Via Maton tab 1. Open Clawdbot Dashboard → Tools → Maton 2. Click Configure 3. Paste your API key 4. Click Save

Step 3: Connect Apps

1. Go to Tools → Maton 2. Click Connect App and select an app (e.g., Gmail, Slack) 3. Complete the OAuth flow in the popup window 4. Once status shows ACTIVE, the connection is ready

Supported Apps

Maton supports 50+ SaaS applications including:

| Category | Apps | |----------|------| | Google Workspace | Gmail, Calendar, Docs, Sheets, Drive, Slides, Ads, Analytics | | Productivity | Notion, Airtable, Jira, Calendly | | Communication | Slack, Outlook | | CRM | HubSpot, Apollo | | Media | YouTube |

API Reference

Base URL

https://ctrl.maton.ai

Authentication

curl https://ctrl.maton.ai/connections \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /connections | List all connections | | POST | /connections | Create new connection | | GET | /connections/{id} | Get connection details | | DELETE | /connections/{id} | Delete connection |

Connection Status

| Status | Description | |--------|-------------| | PENDING | OAuth flow not completed; url contains OAuth link | | ACTIVE | Connection established and ready to use | | FAILED | Connection failed; reconnection required |

Architecture

Configuration Storage

The Maton API key is stored in the main Clawdbot config file:

{
  "env": {
    "MATON_API_KEY": "your-api-key-here"
  }
}

This integrates with the API Keys tab for centralized key management.

Backend RPC Methods

| Method | Purpose | |--------|---------| | maton.status | Get API key status and connection count | | maton.save | Validate and store API key | | maton.test | Test the API key | | maton.disconnect | Remove API key | | maton.connections | List all connections | | maton.connect | Create a new connection (returns OAuth URL) | | maton.delete | Delete a connection | | maton.apps | List supported apps |

UI Components

| File | Purpose | |------|---------| | maton-backend.ts | Gateway RPC handlers | | maton-controller.ts | UI state management | | maton-views.ts | Lit HTML templates |

Installation

See reference/README.md for detailed integration instructions.

Quick Integration

1. Copy backend handler to src/gateway/server-methods/maton.ts 2. Copy UI files to ui/src/ui/views/ and ui/src/ui/controllers/ 3. Add "maton" tab to navigation 4. Add MATON_API_KEY to API keys discovery 5. Rebuild and restart

UI Features

Maton Tab (Tools → Maton)

API Keys Tab Integration

Security

| Aspect | Implementation | |--------|----------------| | Key Storage | Main config file (~/.clawdbot/clawdbot.json) | | Key Access | Never exposed to AI agent | | OAuth Tokens | Managed by Maton (automatic refresh) |

Best practices:

Troubleshooting

"Unauthorized" error

Connection stuck in PENDING

Connection shows FAILED

Maton not in API Keys tab

Reference Files

Support

Step 1: Get Your API Key

1. Go to maton.ai and sign in 2. Navigate to Settings → API Keys 3. Create or copy your API key

Step 2: Configure in Clawdbot UI

Option A: Via API Keys tab 1. Open Clawdbot Dashboard → Settings → API Keys 2. Find "Maton" in the Environment Keys section 3. Enter your API key and click Save

Option B: Via Maton tab 1. Open Clawdbot Dashboard → Tools → Maton 2. Click Configure 3. Paste your API key 4. Click Save

Step 3: Connect Apps

1. Go to Tools → Maton 2. Click Connect App and select an app (e.g., Gmail, Slack) 3. Complete the OAuth flow in the popup window 4. Once status shows ACTIVE, the connection is ready

1. Maton Account — Sign up at maton.ai 2. API Key — Get your API key from the Maton dashboard 3. Clawdbot Gateway — v2026.1.0 or later with UI enabled

"Unauthorized" error

Connection stuck in PENDING

Connection shows FAILED

Maton not in API Keys tab