# Grain MCP

> Grain manages your team's meeting intelligence. Connect it to any AI agent and gain control over recordings, transcripts, and automated insights from every call. You can list all meetings, search across discussions for specific keywords like 'pricing strategy,' extract full transcripts with speaker names, or automatically track follow-up action items.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Tags:** transcription, meeting-notes, ai-summarization, action-items, video-recording

## Description

Stop wasting time playing detective through weeks of meeting notes. This MCP connects directly to your Grain workspace, giving your AI client the ability to treat recorded conversations like searchable databases. You can ask your agent what happened in a specific project discussion months ago and get an immediate summary. It reads every recording, not just the summaries—it pulls full transcripts with speaker attribution so you know exactly who said what.

Beyond summarizing content, you can pull out all detected action items or even ingest external video URLs to process new data streams without manual uploads. This capability lets your agent build a complete picture of team knowledge and decisions across platforms. By connecting this MCP through Vinkius, you give any compatible AI client the full power of structured meeting intelligence, turning raw audio into actionable text right where you need it.

## Tools

### list_recordings
Retrieves a list of all meeting recordings available in your Grain workspace.

### get_recording
Fetches detailed metadata and full information for one specific recorded meeting.

### list_highlights
Lists all the curated, key clips that users have marked within a given recording.

### get_transcript
Retrieves the full meeting transcript, including timestamps and who said what.

### list_tags
Lists all custom tags that have been applied to recordings or highlights for organization.

### search_recordings
Runs a keyword search across the titles and content of every meeting recording.

### get_action_items
Extracts all explicit follow-up tasks identified by Grain from a specific meeting recording.

### list_shared_clips
Lists any specific video clips that have been shared out of the workspace.

### get_current_user
Retrieves and confirms your authenticated profile details within Grain.

### list_workspace_members
Lists every member account currently connected to the Grain workspace.

### upload_video
Processes an external video by passing a public URL for analysis and structuring.

### get_insights
Retrieves high-level, AI-generated summaries, sentiment maps, and key takeaways from a recording.

## Prompt Examples

**Prompt:** 
```
List my meeting recordings from today
```

**Response:** 
```
Retrieving your recordings... I found 2 meetings today: 'Product Roadmap Sync' (45m) and 'Client Q&A'. Would you like the AI summary or action items for the roadmap sync?
```

**Prompt:** 
```
What were the key decisions in the 'Roadmap Sync' meeting?
```

**Response:** 
```
Retrieving insights... In the 'Roadmap Sync', the team decided to: 1. Prioritize the API V2 launch for June. 2. Postpone the dashboard refactor to Q3. I've also identified 3 linked action items for the engineering team.
```

**Prompt:** 
```
Search for recordings mentioning 'pricing strategy'
```

**Response:** 
```
Searching recordings... I found 3 meetings mentioning 'pricing strategy'. The most relevant is 'Q3 Pricing Workshop' from last Friday. Would you like to see the specific transcript segments where this was discussed?
```

## Capabilities

### Find specific meetings
List all recordings in your workspace or search across every recording using a simple keyword query.

### Get detailed meeting data
Retrieve full details for any single recording, including comprehensive transcripts and AI-generated high-level insights.

### Extract decisions and tasks
Pull all key takeaways, automatically identifying specific action items or core decisions made during a call.

### Analyze language content
Download the full transcript of a meeting with timestamps and speaker attribution mapped out clearly.

### Manage team structure
List all members currently in your Grain workspace, keeping your internal user map accurate.

## Use Cases

### Auditing Product Decisions
A PM needs to know the exact consensus on a feature six months ago. They ask their agent to run `search_recordings` for 'database migration'. The tool finds three relevant meetings, and the user then asks for `get_insights` from the most recent one to understand the final decision.

### Verifying Client Commitments
A Sales Lead needs proof of a verbal commitment made during a client call. They ask their agent about 'annual contract terms.' The MCP uses `search_recordings` and then pulls the specific segments via `get_transcript` to quote the exact moment the term was mentioned.

### Onboarding New Team Members
An Operations team member needs to know who reports into which manager. They ask their agent to run `list_workspace_members`. The tool provides a clean, current map of all authenticated users in the Grain workspace.

### Handling External Content
The marketing team receives an external competitor video and needs it analyzed. They use `upload_video` to pass the public URL, allowing the MCP to ingest and process the content using Grain's full AI pipeline.

## Benefits

- You stop manually taking notes. When you run `get_action_items`, your agent extracts all necessary follow-up tasks, automating post-call workflows for you.
- Searching is instant. Instead of sifting through folders, running `search_recordings` lets you find discussions about 'pricing strategy' across every meeting in seconds.
- You never lose context. The ability to run `get_transcript` provides a full, timestamped record showing exactly who said what, eliminating guesswork on complex topics.
- Audit team decisions easily. Use `list_recordings` and then follow up with `get_insights` to get high-level summaries, sentiment mapping, and key takeaways from any discussion.
- Integrate external content seamlessly. Upload an outside video using `upload_video`, letting Grain process it alongside your existing workspace data.

## How It Works

The bottom line is that once connected, your AI client treats Grain as another source of truth for all things meeting-related.

1. Subscribe to this MCP and enter your Grain API Key (you find this key within your Grain Workspace Settings).
2. Authorize the connection with your AI client, allowing it permission to access meeting data.
3. Tell your agent what you need—for example, 'What action items came out of last week's product sync?'—and get an immediate response.

## Frequently Asked Questions

**How does Grain MCP help with transcripts?**
The MCP uses the `get_transcript` tool to retrieve a full, timestamped transcript that includes specific speaker names. This means you know exactly who said every line of dialogue.

**Can I find key action items using Grain? (using get_action_items)**
Yes, the `get_action_items` tool scans the recording and pulls out all explicit follow-up tasks. This automates the task assignment process after a meeting.

**How do I search across multiple meetings? (using search_recordings)**
You use `search_recordings` to scan every recording in your workspace by keyword. It finds all discussions related to that term, no matter when the meeting took place.

**Does Grain MCP work with videos I find online? (using upload_video)**
Yes, you can use `upload_video` by passing a public URL. The MCP processes external video streams and structures them for analysis alongside your internal data.

**What is the difference between get_insights and get_transcript?**
The transcript provides raw, word-for-word text with speakers. `get_insights` takes that data and delivers high-level summaries, sentiment analysis, and key takeaways.