agent-toolkit

# Maton Agent Toolkit This repo helps you connect AI agents to [Maton](https://maton.ai), which allows you to connect and automate 150+ apps (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, and more) through a unified API. ## Model Context Protocol (MCP) Maton hosts a remote MCP server at `https://mcp.maton.ai`. It supports both **OAuth** and **API key** (`Authorization: Bearer` header) authentication, so you can connect securely from any MCP client. - **Remote (OAuth):** point your MCP client at `https://mcp.maton.ai` and complete the OAuth flow in the browser. - **Local (API key):** run the local proxy with `npx -y @maton/mcp --api-key=YOUR_MATON_API_KEY`. See the [MCP package](/tools/modelcontextprotocol) for setup instructions, Docker usage, and the full list of tools. ## Agent Toolkit The Maton Agent Toolkit connects popular agent frameworks to the Maton MCP server through function calling. It discovers the tools available on `https://mcp.maton.ai` and exposes them in each framework's native format. - **TypeScript** ([`@maton/agent-toolkit`](/tools/typescript)) — LangChain, Vercel's AI SDK, OpenAI, MCP. - **Python** ([`maton-agent-toolkit`](/tools/python)) — OpenAI Agents SDK, LangChain, CrewAI, Strands. ```bash npm install @maton/agent-toolkit # TypeScript uv pip install maton-agent-toolkit # Python ``` ## Plugins We ship plugins for popular agent harnesses that wire up the Maton MCP server for you. Each plugin registers the remote server at `https://mcp.maton.ai`, so once installed the Maton tools are available and you complete the OAuth flow in your browser on first use. ### Claude Code Add this repo as a plugin marketplace, then install the Maton plugin: ```bash claude plugin marketplace add maton-ai/agent-toolkit claude plugin install maton@maton-plugins ``` ### Cursor 1. Run `/add-plugin`. 2. Click **Browse marketplace**. 3. Paste the repo link: `https://github.com/maton-ai/agent-toolkit`. 4. Install the plugin. ### Codex Add this repo as a plugin marketplace, then install the Maton plugin: ```bash codex plugin marketplace add maton-ai/agent-toolkit codex plugin add maton@maton-plugins ``` ### OpenClaw Register the Maton MCP server in your `openclaw.json` under `mcp.servers`, then authenticate via OAuth in the browser on first use: ```json { "mcp": { "servers": { "maton": { "url": "https://mcp.maton.ai", "transport": "streamable-http", "auth": "oauth" } } } } ``` ## Manual installation If you'd rather not use a plugin, register the Maton MCP server directly in your MCP client config (`.mcp.json` for Claude Code, `mcp.json` for Cursor): ```json { "mcpServers": { "maton": { "type": "http", "url": "https://mcp.maton.ai" } } } ``` ## License [MIT](LICENSE)