Maton Agent Toolkit

What is Maton Agent Toolkit about?

Enables AI agents to call Maton APIs through function calling, supporting the Model Context Protocol (MCP) and offering a TypeScript library that abstracts dozens of third‑party services.

How to use Maton Agent Toolkit?

Install the library (optional if you only need the MCP server):
```
npm install @maton/agent-toolkit
```
Run the MCP server with npx (no local build required):
```
npx -y @maton/mcp hubspot --agent --api-key=YOUR_MATON_API_KEY
```
Replace YOUR_MATON_API_KEY with your actual Maton API key or set the MATON_API_KEY environment variable.

Configure Claude Desktop (or any MCP‑compatible client) by adding the server definition to claude_desktop_config.json:

{
  "mcpServers": {
    "maton": {
      "command": "npx",
      "args": ["-y", "@maton/mcp@latest", "hubspot", "--actions=all", "--api-key=YOUR_MATON_API_KEY"]
    }
  }
}

Use the provided actions (e.g., create-contact, list-contacts, create-deal, etc.) from your agent code.

Key Features

Full MCP support for seamless integration with AI agents.
TypeScript SDK that wraps a large catalog of API actions.
Over 80 ready‑to‑use actions across services such as HubSpot, Stripe, Slack, Google, AWS, and more.
One‑command deployment via npx – no manual build or Docker setup required.
Environment‑variable fallback for API keys (MATON_API_KEY).

Use Cases

Customer Relationship Management bots that create or update HubSpot contacts and deals.
Financial assistants leveraging Stripe actions for customers and invoices.
Productivity agents that manage Google Calendar events, Docs, Sheets, and Drive files.
Support automation using Slack messaging and ticketing integrations (Jira, Asana, ClickUp).
Marketing workflows that interact with Mailchimp, Klaviyo, or Typeform data.

FAQ

Do I need to clone the repository to run the server? No. The server can be launched directly with npx.
Which Node version is required? Node 18 or newer.
How should I provide my API key? Pass it with --api-key=... or set the MATON_API_KEY environment variable.
Can I limit actions to a subset? Yes. Use --actions= followed by a comma‑separated list of action names.
Is the TypeScript library required for MCP usage? No. The library is optional and only needed if you want to call the actions programmatically from TypeScript code.

The Maton Agent Toolkit enables popular agent frameworks including Model Context Protocol (MCP) to integrate with Maton APIs through function calling. The library is not exhaustive of the entire Maton API. It includes support for Typescript.

The toolkit was inspired by Stripe Agent Toolkit, and its implementation shares similarities with the Stripe Agent Toolkit codebase.

Included below are basic instructions, but refer to the TypeScript package for more information.

To get started, get your API key in your Maton Dashboard and check out documentation.

TypeScript

Installation

You don't need this source code unless you want to modify the package. If you just want to use the package run:

npm install @maton/agent-toolkit

Requirements

Node 18+

Usage

Model Context Protocol

The Maton Agent Toolkit also supports the Model Context Protocol (MCP).

To run the Maton MCP server using npx, use the following command:

API Agent (Beta)

# To use API agent
npx -y @maton/mcp hubspot --agent --api-key=YOUR_MATON_API_KEY

API Action

# To set up all available API actions
npx -y @maton/mcp hubspot --actions=all --api-key=YOUR_MATON_API_KEY

# To set up all available API actions
npx -y @maton/mcp hubspot --actions=create-contact,list-contacts --api-key=YOUR_MATON_API_KEY

Replace YOUR_MATON_API_KEY with your actual Maton API key. Or, you could set the MATON_API_KEY in your environment variables. You can get your API key in your Maton Dashboard.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

{
  "mcpServers": {
    "maton": {
      "command": "npx",
      "args": [
        "-y",
        "@maton/mcp@latest",
        "hubspot",
        "--actions=all",
        "--api-key=YOUR_MATON_API_KEY"
      ]
    }
  }
}

Make sure to replace YOUR_MATON_API_KEY with your actual Maton API key. Alternatively, you could set the MATON_API_KEY in env variables. You can get your API key in your Maton Dashboard.

Available API actions

App	Action
`airtable`	`list-bases`
`airtable`	`list-records`
`airtable`	`list-tables`
`asana`	`create-task`
`asana`	`get-task`
`asana`	`list-projects`
`asana`	`list-tasks`
`asana`	`list-workspaces`
`aws`	`get-s3-object`
`aws`	`list-s3-buckets`
`aws`	`list-s3-objects`
`calendly`	`get-event`
`calendly`	`list-event-invitees`
`calendly`	`list-event-types`
`calendly`	`list-events`
`clickup`	`create-task`
`clickup`	`delete-task`
`clickup`	`get-task`
`clickup`	`list-folders`
`clickup`	`list-lists`
`clickup`	`list-spaces`
`clickup`	`list-tasks`
`clickup`	`list-workspaces`
`google-calendar`	`create-event`
`google-calendar`	`delete-event`
`google-calendar`	`get-calendar`
`google-calendar`	`get-event`
`google-calendar`	`list-calendars`
`google-calendar`	`list-events`
`google-calendar`	`update-event`
`google-docs`	`append-text`
`google-docs`	`create-document`
`google-docs`	`find-document`
`google-docs`	`get-document`
`google-drive`	`create-file`
`google-drive`	`create-folder`
`google-drive`	`delete-file`
`google-drive`	`find-file`
`google-drive`	`find-folder`
`google-drive`	`get-file`
`google-drive`	`list-files`
`google-mail`	`add-label-to-email`
`google-mail`	`create-draft`
`google-mail`	`find-email`
`google-mail`	`list-labels`
`google-mail`	`send-email`
`google-mail`	`remove-label-from-email`
`google-sheet`	`add-column`
`google-sheet`	`add-multiple-rows`
`google-sheet`	`clear-cell`
`google-sheet`	`clear-rows`
`google-sheet`	`create-spreadsheet`
`google-sheet`	`create-worksheet`
`google-sheet`	`delete-rows`
`google-sheet`	`delete-worksheet`
`google-sheet`	`find-row`
`google-sheet`	`get-cell`
`google-sheet`	`get-spreadsheet`
`google-sheet`	`get-values-in-range`
`google-sheet`	`list-worksheets`
`google-sheet`	`update-cell`
`google-sheet`	`update-multiple-rows`
`google-sheet`	`update-row`
`hubspot`	`create-contact`
`hubspot`	`get-contact`
`hubspot`	`list-contacts`
`hubspot`	`search-contacts`
`hubspot`	`merge-contacts`
`hubspot`	`update-contact`
`hubspot`	`delete-contact`
`hubspot`	`create-deal`
`hubspot`	`get-deal`
`hubspot`	`list-deals`
`hubspot`	`search-deals`
`hubspot`	`merge-deals`
`hubspot`	`update-deal`
`hubspot`	`delete-deal`
`jira`	`list-clouds`
`jira`	`get-issue`
`jira`	`list-issues`
`jira`	`add-comment-to-issue`
`jira`	`list-comments`
`jira`	`update-comment`
`jira`	`list-projects`
`jira`	`get-user`
`jira`	`list-users`
`jotform`	`list-forms`
`jotform`	`list-submissions`
`klaviyo`	`add-profiles-to-list`
`klaviyo`	`assign-template-to-campaign-message`
`klaviyo`	`create-campaign`
`klaviyo`	`create-list`
`klaviyo`	`create-profile`
`klaviyo`	`create-template`
`klaviyo`	`get-campaign-messages`
`klaviyo`	`get-campaign-send-job`
`klaviyo`	`get-campaigns`
`klaviyo`	`get-lists`
`klaviyo`	`get-profiles-for-list`
`klaviyo`	`get-profiles`
`klaviyo`	`get-templates`
`klaviyo`	`send-campaign`
`mailchimp`	`get-campaign`
`mailchimp`	`search-campaign`
`notion`	`create-page`
`notion`	`find-page`
`notion`	`get-page`
`outlook`	`create-draft`
`outlook`	`find-email`
`outlook`	`send-email`
`pipedrive`	`search-people`
`salesforce`	`create-contact`
`salesforce`	`get-contact`
`salesforce`	`list-contacts`
`shopify`	`create-order`
`shopify`	`get-order`
`shopify`	`list-orders`
`slack`	`list-channels`
`slack`	`list-messages`
`slack`	`list-replies`
`slack`	`send-message`
`stripe`	`create-customer`
`stripe`	`create-invoice-item`
`stripe`	`create-invoice`
`stripe`	`delete-customer`
`stripe`	`get-customer`
`stripe`	`get-invoice`
`stripe`	`list-customers`
`stripe`	`list-invoices`
`typeform`	`get-form`
`typeform`	`list-forms`
`typeform`	`list-responses`
`youtube`	`list-videos`
`youtube`	`search-videos`

{ "mcpServers": { "maton": { "command": "npx", "args": [ "-y", "@maton/mcp", "hubspot", "--agent" ], "env": { "API_KEY": "<YOUR_API_KEY>" } } } }

Maton Agent Toolkit