Skip to main content

Providers

A provider is a service you can connect to your project, identified by a provider ID such as linear or google-mail. Providers can supply tools, channels, or both.

Provider directory
Direct link to Provider directory

This directory covers the generated toolsets and channel setup documented here, rather than every provider in the platform catalog. Run mastra connect list to see providers available to your project and their connection status.

Provider IDProviderGives you
clerk ClerkTools
discord DiscordTools, Channels
fireflies Fireflies.aiTools
github GitHubTools
google-calendar Google CalendarTools
google-docs Google DocsTools
google-drive Google DriveTools
google-mail GmailTools
google-sheet Google SheetsTools
hubspot HubSpotTools
incident-io incident.ioTools
jira JiraTools
linear LinearTools
microsoft-teams Microsoft TeamsTools, Channels
notion NotionTools
openai OpenAITools
posthog PostHogTools
resend ResendTools
slack SlackTools
slack-channels Slack channelsChannels
snowflake SnowflakeTools
supabase SupabaseTools
telegram TelegramChannels
workos WorkOSTools

Generated toolsets are included in @mastra/connect. Upgrading the package gives you toolsets added in newer releases, but provider availability depends on the platform catalog. The provider toolsets reference lists the generated tools.

MCP providers
Direct link to MCP providers

These providers serve their tools from a hosted Model Context Protocol (MCP) server. The tools come from the provider at runtime, so check each provider's MCP documentation for what it offers. See the MCP tools reference for tool naming and Require approval for sensitive tools for approval setup.

Provider IDProviderProvider MCP docs
attio-mcp AttioAttio MCP
canva-mcp CanvaCanva MCP
clay-mcp ClayMCP in Clay
neon-mcp NeonNeon MCP server
render-mcp RenderRender MCP server
robinhood-mcp RobinhoodAgentic Trading
sanity-mcp SanitySanity MCP server

Troubleshoot a connection
Direct link to Troubleshoot a connection

Most provider call failures come from the connection's credential or configuration. A proxy_error carries the provider's response in its status and detail properties.

  • Status 401: Check whether the credential has expired, been revoked, or been rotated. If it needs replacing, reauthorize the connection.
  • Status 403: Check the provider's response for missing scopes, resource-access restrictions, or account requirements. Grant only the access the agent needs. You can exclude unsupported operations with allowTools, but filtering tools doesn't change the credential's permissions.
  • No tools from a provider: Run mastra connect list to check the project and connection status. Check provider selection and tool filters, and confirm that your installed @mastra/connect version includes the toolset. Connection changes follow the resolver's caching behavior. Check app logs for [@mastra/connect] Skipping warnings when a connection can't be resolved.
  • Resend won't connect: Use an API key with Full access permission. A Sending access key fails to connect because Mastra checks a new key by listing your domains, which sending access keys can't do.

See errors for every error code.

On this page