Grain MCP Server

Official Grain MCP server for accessing meeting recordings, AI notes, transcripts, clips, tags, HubSpot-linked deals, and coaching scorecards.

Collaboration by Grain OAuth2 active

Connect (Remote Server) Docs

Overview

Grain is an AI notetaker that records, transcribes, and analyzes sales and customer meetings. The official Grain MCP server, released June 18, 2025, exposes a workspace's meeting library to AI agents over a remote streamable HTTP endpoint at https://api.grain.com/_/mcp. Authentication is handled via OAuth, so users connect through their MCP client without provisioning API keys.

The server provides roughly 22 tools spanning meeting retrieval, hybrid semantic plus keyword search across transcript segments, AI note and action item extraction, clip creation with smart boundary detection, tag management, playlist creation, workspace user and company listings, HubSpot-linked deal lookup, and access to AI-generated sales coaching scorecards. It also ships built-in MCP Prompts for one-click reports including Voice of the Customer summaries, Pipeline IQ analysis, SPICED/MEDDICC deal reviews, and Sales Skill Scorecards.

The server works natively with Claude Integrations and ChatGPT Connectors, and with mcp-remote for clients like Cursor, Windsurf, and Claude Desktop. It is the canonical first-party Grain MCP server; community repos exist but are not maintained by Grain.

Tools

Tool	Description
`list_meetings`	Return a filtered list of Grain meetings the user has access to, ordered by most recent, with cursor pagination.
`get_meeting`	Fetch information about a single Grain meeting by ID.
`search_meetings`	Hybrid semantic and keyword search over meeting transcript segments, returning matched segments grouped by meeting and ordered by relevancy.
`get_meeting_transcript`	Fetch the full transcript from a single Grain meeting by ID.
`get_meeting_notes`	Return AI notes for a meeting as markdown text, falling back to transcript for older meetings.
`get_action_items`	Extract action items from a meeting including task description, timestamp, status, due date, and assignee.
`create_clip`	Create a clip on a recording at a given timestamp, with smart boundary detection for optimal clip start and end points.
`add_tag`	Add a tag to one or more meetings by recording ID, creating the tag if it does not already exist.
`remove_tag`	Remove a tag from one or more meetings by recording ID.
`list_users`	Get information about all users in the workspace, returning each user's person ID for use in listing recordings attended by that person.
`list_companies`	Return a filtered list of companies that were participants in Grain meetings the user has access to.
`list_deals`	List status of HubSpot-linked deals synced in Grain with pagination support.
`get_deal`	Fetch detailed information about a HubSpot-linked deal including activity history.
`list_scorecards`	List AI-generated sales coaching feedback and scorecards for a filtered set of meetings.
`get_scorecard`	Fetch the AI-generated coaching scorecard for a single meeting by ID.
`create_playlist`	Create a new empty playlist with restricted visibility.
`add_to_playlist`	Add recordings or clips to an existing playlist.

Setup Guide

Prerequisites

A Grain workspace with access to the meetings, deals, and scorecards you want to expose
An MCP client that supports remote streamable HTTP servers (Claude Desktop / Claude Integrations, ChatGPT with Pro plan, Cursor, Windsurf, etc.)

Server URL

https://api.grain.com/_/mcp

Authentication is OAuth, completed in your browser when the MCP client first connects. No API key configuration is required.

Claude Integrations or ChatGPT Connectors

Add a new integration / custom connector using the URL above and complete the Grain OAuth flow.

Cursor, Windsurf, Claude Desktop via mcp-remote

Add the following to your MCP client config:

{
  "mcpServers": {
    "grain": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.grain.com/_/mcp"]
    }
  }
}

On first launch, mcp-remote will open a browser window for the Grain OAuth flow. Tokens are cached locally for subsequent runs.

Use Cases

Generate a weekly Voice of the Customer report by searching recent meeting transcripts for product feedback, feature requests, and sentiment signals.
Identify at-risk deals by pulling HubSpot-linked deals from Grain and cross-referencing them with recent call transcripts and coaching scorecards.
Run SPICED or MEDDICC deal reviews by aggregating notes, transcripts, and action items across every meeting tied to a specific company or deal.
Build sales coaching dashboards by listing AI scorecards across a rep's recent calls and summarizing trends in skills like discovery, objection handling, and next steps.
Auto-create highlight clips from meetings (for example, every time a customer mentions a competitor) and add them to a shared playlist for the team.

Example Prompts

"Search my last 30 days of Grain calls for mentions of churn risk and summarize the top themes."
"List every HubSpot-linked deal in Grain that is in Stage 3 or later and show the most recent meeting transcript for each."
"Pull the coaching scorecards for Jane's last 10 demos and tell me which skill she should work on next."
"Find the moment in yesterday's customer call where they asked about pricing, create a clip, and add it to the 'Pricing Objections' playlist."
"Generate a Voice of the Customer report for this week, grouped by feature request, with quotes and links to the source meetings."

Pros

Official, first-party server maintained by Grain with OAuth authentication and no API key handling.
Broad coverage of the Grain data model: meetings, transcripts, AI notes, action items, clips, tags, playlists, scorecards, and HubSpot-linked deals.
Ships with built-in MCP Prompts for common workflows (Voice of the Customer, Pipeline IQ, SPICED/MEDDICC, Sales Skill Scorecards).
Hybrid semantic plus keyword search over transcript segments returns results grouped by meeting and ordered by relevancy.

Limitations

Requires a Grain account and the Grain features you want to query (HubSpot sync, coaching scorecards) to be enabled on your workspace plan.
Detailed per-tool schema documentation is not published publicly; users typically discover inputs through the MCP client's tool listing.
Remote-only: there is no self-hostable open-source version from Grain, so the server cannot be run inside a private network.

Alternatives

Granola MCP: Community and third-party MCP integrations for the Granola AI notetaker, focused on meeting notes and transcripts.
Gong: Has a partner ecosystem and APIs that several community MCP servers wrap for revenue intelligence use cases.
Fireflies.ai: Offers an API and community MCP wrappers for meeting recordings, transcripts, and summaries.