How to Use the Nylas MCP in Mastra AI

Q: How do I configure Mastra AI to use the Nylas MCP Server tools?

Initialize the Mastra AI MCPClient with your Vinkius server URL and pass the registered tools into your agent instance. The client automatically registers Nylas tools like listmessages and listcalendars for your workflows.

Q: Can Mastra AI workflows retry failed Nylas calendar operations?

Yes, you can wrap Nylas tools like createevent or deleteevent in Mastra AI workflow steps with custom retry policies. If the underlying provider API throws a transient error, Mastra AI handles the backoff automatically.

Q: How do I implement human-in-the-loop approvals for Nylas email sending in Mastra AI?

Set the requireToolApproval option to true for the Nylas sendmessage tool in your Mastra AI configuration. This halts the workflow and alerts your system before any outbound email is actually sent.

Run resilient email and calendar workflows using Mastra AI agents integrated with the managed Nylas MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nylas MCP to Mastra AI

Create your Vinkius account to connect Nylas to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nylas with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate resilient email workflows with Mastra AI

The `send_message` tool dispatches outbound emails directly within Mastra AI workflow steps. If the native mail provider rate-limits the request, Mastra AI uses its built-in retry engine to back off and try again automatically. You can chain this with `list_drafts` to inspect pending communications before firing them off inside a Mastra AI workflow. The entire sequence runs as a structured state machine, ensuring no Nylas email gets lost during network hiccups.

Run multi-step Nylas calendar syncs with auto-retries

The `list_events` tool retrieves calendar schedules to feed Mastra AI's conditional branching logic. For example, if a calendar conflict is detected, your Mastra AI agent branches to execute `delete_event` and reschedule using `create_event`. You declare these steps in a Mastra AI workflow file, passing the MCP client tools directly into the agent definition. The framework handles execution order and state transitions across your Nylas connected calendars.

Guard Nylas contact creation with Mastra AI approval gates

The `create_contact` tool registers new address book entries only after passing Mastra AI's approval gates. By setting `requireToolApproval` in your Mastra AI agent config, you prevent the model from writing junk data to your synchronized contacts. The Mastra AI agent first runs `list_contacts` to verify if the record exists, then pauses for admin confirmation. Once approved, the contact details commit to your Google or Outlook account via Nylas instantly.

Setup guide

Set up Nylas MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Nylas tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "nylas-mcp-client",
  servers: {
    "nylas-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Nylas Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Nylas tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Nylas transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nylas. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nylas now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nylas MCP in Mastra AI

Initialize the Mastra AI `MCPClient` with your Vinkius server URL and pass the registered tools into your agent instance. The client automatically registers Nylas tools like `list_messages` and `list_calendars` for your workflows.

Yes, you can wrap Nylas tools like `create_event` or `delete_event` in Mastra AI workflow steps with custom retry policies. If the underlying provider API throws a transient error, Mastra AI handles the backoff automatically.

Set the `requireToolApproval` option to true for the Nylas `send_message` tool in your Mastra AI configuration. This halts the workflow and alerts your system before any outbound email is actually sent.

Mastra AI automatically detects whether the server uses SSE or Streamable HTTP transports. It maintains a persistent connection so your agent can execute rapid-fire queries like `list_folders` without connection lag.

All synchronized calendar events and contact records pass through encrypted memory states within your local Mastra AI runtime. The Vinkius MCP Server sandbox processes `list_events` and `create_contact` in real-time, never caching your address book or schedules.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript