Grain MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Grain MCP or direct API to search meetings, review transcripts, find key moments, and organize meeting insights through natural language.

Grain logoGrain
Api Key

Grain is a meeting platform that records, transcribes, and organizes team conversations. It helps teams review discussions, share key insights, and keep meeting content easy to find.

17 Tools

Try Grain now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Grain
Try asking
TOOLS

Supported Tools

Every Grain action and event your agent gets out of the box.

Create Hook

Create a Grain webhook subscription after Grain verifies that the public HTTPS callback returns a 2xx response.

Create Upload

Create a Grain transcript upload or an audio/video upload slot.

Delete Hook

Permanently delete one Grain webhook subscription.

Download Recording

Download a recording's original audio or video media through Composio file storage.

Get Connection Info

Identify the connected Grain user or workspace and report the connection's authentication type, scope, and expiry without exposing credentials.

Get Recording

Get one Grain recording by ID, optionally including participants, summaries, notes, and other expanded meeting data.

Get Recording Transcript

Get a Grain recording transcript as structured speaker segments, plain text, WebVTT, or SRT.

Get Upload

Get one Grain upload by ID, including its processing status and optional attributes or transcript data.

List Hooks

List Grain webhook subscriptions, optionally filtering by event type or enabled state.

List Recordings

Return one page of recordings visible to the connected Grain user, with optional search filters and expanded meeting data.

List Reference Data

List visible Grain users, teams, or meeting types and return their IDs for recording filters, sharing, and upload metadata.

List Uploads

Return one page of Grain uploads, optionally filtered by media type and expanded with attributes or transcript data.

Promote Upload

Start promotion of a manually staged Grain upload into a recording.

Update Recording Access

Share a recording with one Grain user or team, or remove that user or team's access.

Update Recording Tag

Add or remove one tag on a Grain recording.

Update Recording Title

Replace the title of an existing Grain recording.

Update Upload

Replace attributes on an awaiting or manually staged Grain upload before it is promoted.

SETUP GUIDE

Connect Grain MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["grain"],
  mcp: true,
});
Create a session scoped to Grain and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List my five most recent Grain meeting recordings",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Grain request
SETUP GUIDE

Connect Grain API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["grain"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Grain
3

Run Grain tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List my five most recent Grain meeting recordings" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Grain tool calls through the session, and print the final answer

Why Use Composio?

AI Native Grain Integration

  • Supports both Grain MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for searching meetings, reading transcripts, and finding key moments in your Grain data

Managed Auth

  • Securely stores and manages your Grain API keys
  • Central place to manage, scope, and revoke Grain access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Grain
  • Scoped, least privilege access to Grain resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Grain.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Grain tool your agent needs.Free to start.

Start building