Griptape with Mastra AI

How to integrate Griptape MCP with Mastra AI

Trusted by

GET STARTED FOR FREE GET A DEMO

30 min · no commitment · see it on your stack

Introduction Also integrate Griptape with TL;DR What is Mastra AI What is the Griptape MCP server Supported Tools & Triggers Creating MCP Server - Stand-alone vs Composio SDK Step-by-step Guide Complete Code Conclusion How to build Griptape MCP Agent with another framework Explore Other Toolkits FAQ

Connect Griptape without Auth hassles

We manage OAuth, API Key, token refresh, and scopes, you just build.

Try for Free

Introduction

This guide walks you through connecting Griptape to Mastra AI using the Composio tool router. By the end, you'll have a working Griptape agent that can create a new assistant named 'dochelper', list all assistants available in your workspace, start a run for assistant 'codegenpro' with input data through natural language commands.

This guide will help you understand how to give your Mastra AI agent real control over a Griptape account through Composio's Griptape MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Griptape with

OpenAI Agents SDK Claude Agent SDK Claude Code Claude Cowork Codex OpenClaw Hermes CLI Google ADK LangChain Vercel AI SDK LlamaIndex CrewAI

TL;DR

Here's what you'll learn:

Set up your environment so Mastra, OpenAI, and Composio work together
Create a Tool Router session in Composio that exposes Griptape tools
Connect Mastra's MCP client to the Composio generated MCP URL
Fetch Griptape tool definitions and attach them as a toolset
Build a Mastra agent that can reason, call tools, and return structured results
Run an interactive CLI where you can chat with your Griptape agent

What is Mastra AI?

Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP.

Key features include:

MCP Client: Built-in support for Model Context Protocol servers
Toolsets: Organize tools into logical groups
Step Callbacks: Monitor and debug agent execution
OpenAI Integration: Works with OpenAI models via @ai-sdk/openai

What is the Griptape MCP server, and what's possible with it?

The Griptape MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Griptape account. It provides structured and secure access to your Griptape platform, so your agent can create assistants, launch and monitor AI runs, retrieve logs, and analyze results automatically on your behalf.

Automated assistant creation and management: Easily direct your agent to create new assistants or list existing ones, making it simple to manage your AI resources in Griptape Cloud.
Launching and controlling assistant runs: Let your agent start new assistant runs, cancel ongoing executions, or fetch the status of any run for streamlined AI workflow management.
Real-time monitoring of assistant activities: Have your agent stream live run events, monitor progress, or retrieve detailed logs to keep tabs on every step of your generative AI processes.
Error handling and diagnostics: Ask your agent to fetch detailed error reports for failed runs, helping you troubleshoot and resolve issues quickly and efficiently.
Result retrieval and historical analysis: Automatically pull final outputs from completed runs and review historical execution data, empowering you to analyze and improve your generative AI pipelines over time.

Supported Tools & Triggers

Tools

Assistant CreationTool to create a new assistant.

List AssistantsTool to list all assistants.

Cancel Assistant RunTool to cancel an ongoing assistant run.

Assistant Run CreationCreates a new assistant run to execute a conversation turn with a Griptape Cloud assistant.

Get Assistant Run Error DetailsTool to fetch detailed error information for a specific assistant run.

List Assistant RunsTool to list all runs for a given assistant.

Assistant Run Logs RetrievalRetrieve the complete execution logs for an assistant run in Griptape Cloud.

Retrieve Assistant RunTool to retrieve an assistant run's status and details.

Retry Assistant RunTool to attempt retrying a failed assistant run.

Cancel Data JobTool to cancel a running or queued data job.

Create BucketTool to create a new bucket in Griptape Cloud.

Create Bucket AssetTool to create a new asset in a Griptape Cloud bucket.

Create Data ConnectorTool to create a new data connector in Griptape Cloud.

Create Data Connector JobTool to create a data job for a data connector in Griptape Cloud.

Create Export JobTool to create a new export job in Griptape Cloud.

Create FunctionTool to create a new function in Griptape Cloud.

Create Function DeploymentTool to create a new deployment for a function from a code source.

Create Import JobTool to create a new import job in Griptape Cloud.

Create IntegrationTool to create a new integration in Griptape Cloud.

Create Knowledge BaseTool to create a new knowledge base in Griptape Cloud.

Create Knowledge Base JobTool to create a knowledge base job for ingesting data into a knowledge base.

Create LibraryTool to create a new library in Griptape Cloud.

Create Model ConfigurationTool to create a new model configuration in Griptape Cloud.

Create Model Auth ConfigTool to create a model authentication configuration in Griptape Cloud.

Create Organization API KeyTool to create a new API key for a specific organization.

Create RetrieverTool to create a new retriever in Griptape Cloud.

Create RuleTool to create a new rule in Griptape Cloud.

Create SecretTool to create a new secret in Griptape Cloud.

Create StructureTool to create a new structure in Griptape Cloud.

Create Structure DeploymentTool to create a new deployment for a structure.

Create ThreadTool to create a new thread in Griptape Cloud.

Create Thread MessageTool to create a new message in a specific thread.

Create Tool DeploymentCreate a new deployment for a tool from a GitHub repository.

Delete API KeyTool to delete an API key by ID.

Delete AssistantTool to delete an assistant by ID.

Delete BucketTool to delete a bucket by ID.

Delete Bucket AssetTool to delete a specific asset from a Griptape Cloud bucket.

Delete Data ConnectorTool to delete a data connector.

Delete FunctionTool to delete a function from Griptape Cloud.

Delete IntegrationTool to delete an integration by ID.

Delete Knowledge BaseTool to delete a Knowledge Base from Griptape Cloud.

Delete LibraryTool to delete a library from Griptape Cloud.

Delete MessageTool to delete a message by its ID.

Delete Model ConfigurationTool to delete a model configuration from Griptape Cloud.

Delete Model Auth ConfigTool to delete a model auth config by ID.

Delete RuleTool to delete a rule by its ID.

Delete RulesetTool to permanently delete a ruleset from Griptape Cloud by its ID.

Delete SecretTool to delete a secret from Griptape Cloud.

Delete StructureTool to delete a structure from Griptape Cloud.

Delete ThreadTool to delete a thread by its ID.

Delete ToolTool to delete a tool from Griptape Cloud.

Get API KeyTool to retrieve an API key's details.

Get AssistantTool to retrieve a specific assistant's details by ID.

Get Billing Management URLTool to retrieve the billing management portal URL.

Get BucketTool to retrieve a bucket's details by its ID.

Get Bucket AssetTool to retrieve a specific asset from a Griptape Cloud bucket.

Get Bucket Asset URLTool to generate a signed URL for accessing or uploading bucket assets.

Get ConfigurationTool to retrieve Griptape Cloud configuration.

Get Credits BalanceTool to retrieve the current credits balance.

Get Data ConnectorTool to retrieve a data connector's configuration and details from Griptape Cloud.

Get Data JobTool to retrieve a data job's status and details by its ID.

Get Export JobTool to retrieve an export job by ID.

Get FunctionTool to retrieve a function's details.

Get Import JobTool to retrieve an import job's status and details.

Get IntegrationTool to retrieve a specific integration's details by ID.

Get Knowledge BaseTool to retrieve a knowledge base's configuration and details from Griptape Cloud.

Get Knowledge Base JobTool to retrieve a knowledge base job's status and details by its ID.

Get Knowledge Base SearchTool to retrieve details of a specific knowledge base search by its ID.

Get LibraryTool to retrieve a specific library's details by ID.

Get MessageTool to retrieve a specific message's details by ID.

Get Model ConfigurationTool to retrieve a model configuration's details by its ID.

Get Model Auth ConfigTool to retrieve a model auth config by ID.

Get OrganizationTool to retrieve an organization's details by its ID.

Get RetrieverTool to retrieve a retriever's details by its ID.

Get Retriever ComponentTool to retrieve a retriever component's details by its ID.

Get RuleTool to retrieve a specific rule's details by ID.

Get RulesetTool to retrieve a specific ruleset's details by ID.

Get Ruleset by AliasRetrieve a ruleset from Griptape Cloud by its unique alias identifier.

Get SecretTool to retrieve a secret's details from Griptape Cloud.

Get StructureTool to retrieve a structure's configuration and details from Griptape Cloud.

Get Structures DashboardTool to retrieve dashboard metrics for structures.

Get ThreadTool to retrieve a specific thread's details by ID.

Get ToolTool to retrieve a specific tool's details by ID.

Get UsageTool to retrieve current usage statistics.

Get UserTool to retrieve a user's details by their ID.

List Assistant Run EventsTool to list events for an assistant run with pagination support.

List Bucket AssetsTool to list assets in a bucket.

List BucketsTool to list all buckets in Griptape Cloud.

List ConnectionsTool to list all connections.

List Data ConnectorsTool to list all data connectors.

List Embedding DriversTool to list available embedding drivers.

List Export JobsTool to list export jobs from Griptape Cloud.

List Function DeploymentsTool to list all deployments for a specific function.

List FunctionsTool to list all functions with optional pagination.

List Import JobsTool to list import jobs in Griptape Cloud.

List IntegrationsTool to list all integrations.

List Knowledge Base JobsTool to list knowledge base jobs for a specific knowledge base.

List Knowledge Base QueriesTool to list all queries made to a specific Griptape Cloud knowledge base.

List Knowledge BasesTool to list all knowledge bases.

List Knowledge Base SearchesTool to list all searches performed on a specific knowledge base.

List LibrariesTool to list all libraries in Griptape Cloud.

List Model Auth ConfigsTool to list all model authentication configurations with optional pagination.

List ModelsTool to list all models in Griptape Cloud.

List Organization API KeysTool to list all API keys in a specific organization.

List OrganizationsTool to list all organizations in Griptape Cloud.

List Retriever ComponentsTool to list all retriever components in Griptape Cloud.

List RetrieversTool to list all retrievers in Griptape Cloud.

List RulesTool to list all rules in Griptape Cloud with optional pagination and filtering.

List SecretsTool to list all secrets in Griptape Cloud.

List Structure DeploymentsTool to list all deployments for a specific structure.

List Structure RunsTool to list all runs for a specific structure with optional pagination and status filtering.

List StructuresTool to list all structures in Griptape Cloud.

List Thread MessagesTool to list all messages in a specific thread.

List ThreadsTool to list all threads.

List Tool DeploymentsTool to list all deployments for a specific tool.

List Tool RunsTool to list all runs for a specific tool with optional pagination and status filtering.

List UsersTool to list all users in Griptape Cloud.

Query knowledge basePerforms semantic search against a Griptape Cloud knowledge base using natural language.

Query RetrieverTool to query a retriever in Griptape Cloud with a natural-language query.

Ruleset CreationCreates a new ruleset in Griptape Cloud.

Search Knowledge BaseSearches a Griptape Cloud Knowledge Base with a natural-language query and returns a synthesized answer.

Create ToolCreate a new tool resource in Griptape Cloud.

Get Tool Deployment StatusTool to retrieve status of a specific tool deployment.

List ToolsTool to list all tools.

Update AssistantTool to update an existing assistant's configuration.

Update BucketTool to update a bucket's properties by its ID.

Update Data ConnectorTool to update a data connector's configuration in Griptape Cloud.

Update FunctionTool to update an existing function's configuration.

Update IntegrationTool to update an existing integration's configuration.

Update Knowledge BaseTool to update a knowledge base's configuration in Griptape Cloud.

Update LibraryTool to update an existing library's configuration in Griptape Cloud.

Update MessageTool to update a message's input, output, and metadata by its ID.

Update Model ConfigurationTool to update a model configuration's properties by its ID.

Update Model Auth ConfigTool to update an existing model auth config's properties.

Update OrganizationTool to update an organization's properties by its ID.

Update RetrieverTool to update an existing retriever's configuration in Griptape Cloud.

Update Retriever ComponentTool to update a retriever component's configuration by its ID.

Update RuleTool to update an existing rule's configuration.

Update RulesetTool to update an existing ruleset's configuration.

Update SecretTool to update a secret's properties by its ID.

Update StructureTool to update an existing structure's configuration.

Update ThreadTool to update an existing thread's configuration.

Update ToolTool to update an existing tool's configuration.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Prerequisites

Before starting, make sure you have:

Node.js 18 or higher
A Composio account with an active API key
An OpenAI API key
Basic familiarity with TypeScript

Getting API Keys for OpenAI and Composio

OpenAI API Key

Go to the OpenAI dashboard and create an API key.
You need credits or a connected billing setup to use the models.
Store the key somewhere safe.

Composio API Key

Log in to the Composio dashboard.
Go to Settings and copy your API key.
This key lets your Mastra agent talk to Composio and reach Griptape through MCP.

Install dependencies

bash

npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv

Install the required packages.

What's happening:

@composio/core is the Composio SDK for creating MCP sessions
@mastra/core provides the Agent class
@mastra/mcp is Mastra's MCP client
@ai-sdk/openai is the model wrapper for OpenAI
dotenv loads environment variables from .env

Set up environment variables

bash

COMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key_here

Create a .env file in your project root.

What's happening:

COMPOSIO_API_KEY authenticates your requests to Composio
COMPOSIO_USER_ID tells Composio which user this session belongs to
OPENAI_API_KEY lets the Mastra agent call OpenAI models

Import libraries and validate environment

typescript

import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({
  apiKey: composioAPIKey as string,
});

What's happening:

dotenv/config auto loads your .env so process.env.* is available
openai gives you a Mastra compatible model wrapper
Agent is the Mastra agent that will call tools and produce answers
MCPClient connects Mastra to your Composio MCP server
Composio is used to create a Tool Router session

Create a Tool Router session for Griptape

typescript

async function main() {
  const session = await composio.create(
    composioUserID as string,
    {
      toolkits: ["griptape"],
    },
  );

  const composioMCPUrl = session.mcp.url;
  console.log("Griptape MCP URL:", composioMCPUrl);

What's happening:

create spins up a short-lived MCP HTTP endpoint for this user
The toolkits array contains "griptape" for Griptape access
session.mcp.url is the MCP URL that Mastra's MCPClient will connect to

Configure Mastra MCP client and fetch tools

typescript

const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      nasdaq: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

console.log("Fetching MCP tools from Composio...");
const composioTools = await mcpClient.getTools();
console.log("Number of tools:", Object.keys(composioTools).length);

What's happening:

MCPClient takes an id for this client and a list of MCP servers
The headers property includes the x-api-key for authentication
getTools fetches the tool definitions exposed by the Griptape toolkit

Create the Mastra agent

typescript

const agent = new Agent({
    name: "griptape-mastra-agent",
    instructions: "You are an AI agent with Griptape tools via Composio.",
    model: "openai/gpt-5",
  });

What's happening:

Agent is the core Mastra agent
name is just an identifier for logging and debugging
instructions guide the agent to use tools instead of only answering in natural language
model uses openai("gpt-5") to configure the underlying LLM

Set up interactive chat interface

typescript

let messages: AiMessageType[] = [];

console.log("Chat started! Type 'exit' or 'quit' to end.\n");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: "> ",
});

rl.prompt();

rl.on("line", async (userInput: string) => {
  const trimmedInput = userInput.trim();

  if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) {
    console.log("\nGoodbye!");
    rl.close();
    process.exit(0);
  }

  if (!trimmedInput) {
    rl.prompt();
    return;
  }

  messages.push({
    id: crypto.randomUUID(),
    role: "user",
    content: trimmedInput,
  });

  console.log("\nAgent is thinking...\n");

  try {
    const response = await agent.generate(messages, {
      toolsets: {
        griptape: composioTools,
      },
      maxSteps: 8,
    });

    const { text } = response;

    if (text && text.trim().length > 0) {
      console.log(`Agent: ${text}\n`);
        messages.push({
          id: crypto.randomUUID(),
          role: "assistant",
          content: text,
        });
      }
    } catch (error) {
      console.error("\nError:", error);
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    console.log("\nSession ended.");
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});

What's happening:

messages keeps the full conversation history in Mastra's expected format
agent.generate runs the agent with conversation history and Griptape toolsets
maxSteps limits how many tool calls the agent can take in a single run
onStepFinish is a hook that prints intermediate steps for debugging

Complete Code

Here's the complete code to get you started with Griptape and Mastra AI:

typescript

import "dotenv/config";
import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
import { MCPClient } from "@mastra/mcp";
import { Composio } from "@composio/core";
import * as readline from "readline";

import type { AiMessageType } from "@mastra/core/agent";

const openaiAPIKey = process.env.OPENAI_API_KEY;
const composioAPIKey = process.env.COMPOSIO_API_KEY;
const composioUserID = process.env.COMPOSIO_USER_ID;

if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set");
if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set");
if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set");

const composio = new Composio({ apiKey: composioAPIKey as string });

async function main() {
  const session = await composio.create(composioUserID as string, {
    toolkits: ["griptape"],
  });

  const composioMCPUrl = session.mcp.url;

  const mcpClient = new MCPClient({
    id: composioUserID as string,
    servers: {
      griptape: {
        url: new URL(composioMCPUrl),
        requestInit: {
          headers: session.mcp.headers,
        },
      },
    },
    timeout: 30_000,
  });

  const composioTools = await mcpClient.getTools();

  const agent = new Agent({
    name: "griptape-mastra-agent",
    instructions: "You are an AI agent with Griptape tools via Composio.",
    model: "openai/gpt-5",
  });

  let messages: AiMessageType[] = [];

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: "> ",
  });

  rl.prompt();

  rl.on("line", async (input: string) => {
    const trimmed = input.trim();
    if (["exit", "quit"].includes(trimmed.toLowerCase())) {
      rl.close();
      return;
    }

    messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed });

    const { text } = await agent.generate(messages, {
      toolsets: { griptape: composioTools },
      maxSteps: 8,
    });

    if (text) {
      console.log(`Agent: ${text}\n`);
      messages.push({ id: crypto.randomUUID(), role: "assistant", content: text });
    }

    rl.prompt();
  });

  rl.on("close", async () => {
    await mcpClient.disconnect();
    process.exit(0);
  });
}

main();

Conclusion

You've built a Mastra AI agent that can interact with Griptape through Composio's Tool Router. You can extend this further by:

Adding other toolkits like Gmail, Slack, or GitHub
Building a web-based chat interface around this agent
Using multiple MCP endpoints to enable cross-app workflows

How to build Griptape MCP Agent with another framework

OpenAI Agents SDK

Use Griptape MCP with OpenAI Agents SDK

Claude Agent SDK

Use Griptape MCP with Claude Agent SDK

Claude Code

Use Griptape MCP with Claude Code

Claude Cowork

Use Griptape MCP with Claude Cowork

Codex

Use Griptape MCP with Codex

OpenClaw

Use Griptape MCP with OpenClaw

Hermes

Use Griptape MCP with Hermes

CLI

Use Griptape MCP with CLI

Google ADK

Use Griptape MCP with Google ADK

LangChain

Use Griptape MCP with LangChain

Vercel AI SDK

Use Griptape MCP with Vercel AI SDK

LlamaIndex

Use Griptape MCP with LlamaIndex

CrewAI

Use Griptape MCP with CrewAI

Explore Other Toolkits

Composio

No Auth

Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.

Composio search

No Auth

Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.

Perplexityai

Api Key

Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.

TOOLKIT MARKETPLACE

FAQ

What are the differences in Tool Router MCP and Griptape MCP?

With a standalone Griptape MCP server, the agents and LLMs can only access a fixed set of Griptape tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Griptape and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with Mastra AI?

Yes, you can. Mastra AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Griptape tools.

Can I manage the permissions and scopes for Griptape while using Tool Router?

Yes, absolutely. You can configure which Griptape scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Griptape data and credentials are handled as safely as possible.

Used by agents from

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for free Get a demo↗

Harsha GaddipatiCo-founder, Slashy

Karan skipped his own birthday party to fix our critical issue. It was 10 pm and he diverted his Waymo to help us instead. This really sets the bar, shows you the commitment you need to have when users rely on your software.

Abhi AryaCo-founder, Opennote

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it has immensely helped in keeping new users on the platform.

Nirman DaveCEO, Zams

We chose Composio over Pipedream because it delivered depth where it mattered. It supported niche tools and tricky edge cases that other platforms simply ignored. Giving us confidence to scale without compromising.

Ryan YuFounder, Extra Thursday

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down in the complexities of managing agent auth would have been a death sentence for Extra Thursday.

Tomisin JenrolaFounder & CEO, SwarmZero

Before partnering with Composio, adding tool integrations was a slow, resource-intensive process. Each integration could take weeks or months of engineering time, and maintaining them meant constantly keeping up with API changes.

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

How to integrate Griptape MCP with Mastra AI

Table of Contents

Connect Griptape without Auth hassles

Introduction

Also integrate Griptape with

TL;DR

What is Mastra AI?

What is the Griptape MCP server, and what's possible with it?

Supported Tools & Triggers

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

How the Composio SDK works

Step-by-step Guide

Prerequisites

Getting API Keys for OpenAI and Composio

Install dependencies

Set up environment variables

Import libraries and validate environment

Create a Tool Router session for Griptape

Configure Mastra MCP client and fetch tools

Create the Mastra agent

Set up interactive chat interface

Complete Code

Conclusion

How to build Griptape MCP Agent with another framework

OpenAI Agents SDK

Claude Agent SDK

Claude Code

Claude Cowork

Codex

OpenClaw

Hermes

CLI

Google ADK

LangChain

Vercel AI SDK

LlamaIndex

CrewAI

Explore Other Toolkits

Composio

Composio search

Perplexityai

FAQ

What are the differences in Tool Router MCP and Griptape MCP?

Can I use Tool Router MCP with Mastra AI?

Can I manage the permissions and scopes for Griptape while using Tool Router?

How safe is my data with Composio Tool Router?

Used by agents from

Never worry about agent reliability