Skip to main content

Connect Hedy with AI Assistants Using MCP

Access your Hedy sessions, highlights, and tasks directly from AI assistants using the Model Context Protocol (MCP).

Updated over 2 weeks ago

What is the Hedy MCP Server?

The Hedy MCP server enables AI assistants to securely access and help organize your Hedy data. Once connected, you can ask your AI to analyze meeting transcripts, find highlights, review action items, create topics, and manage your session contexts—all through natural conversation.

MCP (Model Context Protocol) is an open standard that allows AI applications to connect to external data sources. The Hedy MCP server uses OAuth authentication, making it compatible with web-based AI platforms, desktop applications, and development tools.

How to Connect

Step 1: Add the Server

  1. Open your AI client's MCP server settings

  2. Look for "Add MCP Server", "Connect Remote Server", or "Add Integration"

  3. Enter the server URL: https://api.hedy.bot/mcp

  4. Click "Add" or "Connect"

Step 2: Authorize Access

  1. Your AI client will open a browser window

  2. Sign in with your Hedy account

  3. Review the requested permissions

  4. Click "Allow" to authorize

  5. Return to your AI client

That's it! No configuration files or API keys needed.

Compatible AI Clients

Works with any MCP-compatible client that supports remote servers:

  • Web-based AI platforms - Browser-accessible AI assistants

  • Desktop applications - Claude Desktop, BoltAI, Cursor, Windsurf, Zed

  • Development tools - VS Code with GitHub Copilot, Cline, Claude Code

  • AI agent platforms - Custom workflow builders

Setup Instructions by Client

Claude Code (CLI)

Add the Hedy MCP server with a single command:

claude mcp add --transport http hedy https://api.hedy.bot/mcp

This will trigger the OAuth flow in your browser. Sign in with your Hedy account and authorize access.

Claude Desktop (Pro/Max/Team/Enterprise)

  1. Open Claude Desktop and go to Settings

  2. Scroll to Integrations at the bottom

  3. Click Add more (or Add integration)

  4. Enter:

    • Integration name: Hedy

    • Integration URL: https://api.hedy.bot/mcp

  5. Click Connect and complete the OAuth flow in your browser

  6. In new chats, click the tools icon to enable Hedy tools

Note: Free tier users need to use the mcp-remote bridge. See the project README for configuration.

Cline (VS Code Extension)

Option 1: Via Cline UI (Recommended)

  1. Open VS Code with the Cline extension installed

  2. Click the Cline icon in the sidebar

  3. Click the menu (⋮) and select "MCP Servers"

  4. Select the "Remote Servers" tab

  5. Enter: Server Name: hedy, Server URL: https://api.hedy.bot/mcp, Transport Type: Streamable HTTP

  6. Click "Add Server"

  7. Click "Authenticate" when prompted and complete the OAuth flow in your browser

Option 2: Manual JSON Configuration

  1. Open the Cline MCP settings file:

    • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

    • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

    • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  2. Add this configuration:

    {"mcpServers": {"hedy": {"url": "https://api.hedy.bot/mcp","type": "streamableHttp","disabled": false}}}

  3. Save the file and restart VS Code

  4. The OAuth flow will trigger when Cline attempts to use the server

BoltAI (macOS)

BoltAI connects to MCP servers via local configuration. Because BoltAI doesn't natively support remote OAuth servers, you'll need the mcp-remote bridge.

Requirements: Node.js must be installed on your Mac (node -v to check).

  1. Open BoltAI → Settings → Plugins, click the + button to open mcp.json

  2. Add the following configuration:

    {"mcpServers":{"hedy":{"command":"npx","args":["mcp-remote","https://api.hedy.bot/mcp"]}}}

  3. Click Save Changes

  4. On first use, a browser window will open — sign in with your Hedy account and authorize access

Note: The mcp-remote bridge translates the remote OAuth-enabled server into a local stdio connection that BoltAI can handle. After the first authorization, the token is cached locally.

Cursor / Windsurf / Other IDE Tools

  1. Open MCP settings in your IDE

  2. Add server URL: https://api.hedy.bot/mcp

  3. Select "HTTP" or "Streamable HTTP" as the transport type

  4. Authorize when prompted

Web-Based AI Clients

  1. Find "Connect MCP Server" or "Add Integration"

  2. Enter: https://api.hedy.bot/mcp

  3. Complete OAuth authorization in your browser

Available Tools

The Hedy MCP server provides 18 tools your AI assistant can use to access and organize your meeting data:

Session Tools

GetSessions

What it does: Lists your recent meeting sessions, ordered by start time (newest first)

Parameters:

  • limit (optional) - Number of sessions to return (1-100)

  • after (optional) - Session ID to start pagination after

Example requests:

  • "Show me my last 10 sessions"

  • "List all sessions from this week"

  • "What meetings did I have recently?"

GetSessionDetails

What it does: Retrieves full details for a specific session including metadata, participants, and transcript

Parameters:

  • sessionId (required) - The ID of the session

Example requests:

  • "Show me the details of session ABC123"

  • "What was discussed in my last team meeting?"

  • "Get the transcript for the product launch session"

GetSessionHighlights

What it does: Returns all highlights captured during a specific session

Parameters:

  • sessionId (required) - The ID of the session

Example requests:

  • "What highlights did I save in session ABC123?"

  • "Show me the key moments from yesterday's standup"

  • "List all highlights from the budget meeting"

GetSessionToDos

What it does: Lists all to-do items generated during a specific session

Parameters:

  • sessionId (required) - The ID of the session

  • includeCompleted (optional) - If true, includes completed tasks (default: only open tasks)

Example requests:

  • "What action items came from session ABC123?"

  • "Show me todos from the client meeting, including completed ones"

  • "List pending tasks from yesterday's planning session"

Highlight Tools

GetHighlights

What it does: Lists your recent highlights across all sessions, sorted by newest first

Parameters:

  • limit (optional) - Number of highlights to return (1-100)

  • after (optional) - Highlight ID to start pagination after

Example requests:

  • "Show me my last 20 highlights"

  • "What have I highlighted this week?"

  • "List recent key moments I've saved"

GetHighlightDetails

What it does: Retrieves full details for a specific highlight including transcript snippet, timestamp, and context

Parameters:

  • highlightId (required) - The ID of the highlight

Example requests:

  • "Show me highlight XYZ789 in detail"

  • "What was the context around that budget highlight?"

  • "Get the full transcript for highlight XYZ789"

Task Tools

GetToDos

What it does: Returns all to-do items across all your sessions

Parameters:

  • includeCompleted (optional) - If true, includes completed tasks (default: only open tasks)

Example requests:

  • "What are all my pending action items?"

  • "Show me all todos, including completed ones"

  • "List everything I need to do from my meetings"

Topic Tools

AI assistants can view your topics and also help you organize them by creating new topics, updating existing ones, or removing topics you no longer need.

GetAllTopics

What it does: Lists all your meeting topics and folders

Parameters:

  • includeArchived (optional) - If true, includes archived topics (default: only active topics)

Example requests:

  • "What topics do I have in Hedy?"

  • "List all my meeting categories"

  • "Show me all topics including archived ones"

GetTopicDetails

What it does: Retrieves details for a specific topic including description, session count, and AI-generated insights

Parameters:

  • topicId (required) - The ID of the topic

Example requests:

  • "Show me details for the Client Meetings topic"

  • "How many sessions are in my Team Standups topic?"

  • "What insights does Hedy have about my Product Planning topic?"

GetTopicSessions

What it does: Lists all sessions associated with a specific topic

Parameters:

  • topicId (required) - The ID of the topic

Example requests:

  • "Show me all sessions in the Product Planning topic"

  • "List meetings tagged with Client Meetings"

  • "What sessions are in my 1:1s folder?"

CreateTopic

What it does: Creates a new topic for organizing your meeting sessions

Parameters:

  • name (required) - Name of the topic (max 100 characters)

  • description (optional) - Description of the topic (max 500 characters)

  • color (optional) - Color for the topic (e.g., #FF5733)

  • iconName (optional) - Icon name for the topic

  • topicContext (optional) - Custom instructions for AI analysis of sessions in this topic

Example requests:

  • "Create a new topic called Q1 Planning"

  • "Make a topic for client calls with a blue color"

  • "Set up a new category for interview sessions"

UpdateTopic

What it does: Updates an existing topic's name, description, color, or other settings

Parameters:

  • topicId (required) - The ID of the topic to update

  • name (optional) - New name for the topic

  • description (optional) - New description

  • color (optional) - New color

  • iconName (optional) - New icon

  • topicContext (optional) - New custom instructions for AI analysis

Example requests:

  • "Rename the Q1 Planning topic to Q2 Planning"

  • "Change the color of my Client Meetings topic to green"

  • "Update the description for my Team Standups topic"

DeleteTopic

What it does: Removes a topic. Sessions previously in the topic are preserved but no longer grouped under it.

Parameters:

  • topicId (required) - The ID of the topic to remove

Example requests:

  • "Delete the old Project Alpha topic"

  • "Remove my unused Interview Prep topic"

  • "Get rid of the topic called Test"

Session Context Tools

Session contexts let you provide background information that Hedy uses when analyzing your meetings. AI assistants can help you view and manage these contexts.

ListSessionContexts

What it does: Lists all your saved session contexts, ordered by most recently updated

Example requests:

  • "Show me all my session contexts"

  • "What background contexts do I have set up?"

  • "List my meeting context profiles"

GetSessionContext

What it does: Retrieves the details of a specific session context

Parameters:

  • contextId (required) - The ID of the context to retrieve

Example requests:

  • "Show me my Work context details"

  • "What's in my default session context?"

CreateSessionContext

What it does: Creates a new session context with background information for Hedy to use during analysis

Parameters:

  • title (required) - Title for the context (max 200 characters)

  • content (optional) - The background information and instructions

  • isDefault (optional) - Set this as your default context

Example requests:

  • "Create a new context called Sales Calls with information about my products"

  • "Set up a context for my engineering team meetings"

  • "Make a new default context with my job role and responsibilities"

UpdateSessionContext

What it does: Updates an existing session context

Parameters:

  • contextId (required) - The ID of the context to update

  • title (optional) - New title

  • content (optional) - New background information

  • isDefault (optional) - Set as default context

Example requests:

  • "Update my Work context with my new team structure"

  • "Add information about our Q2 goals to my default context"

  • "Change my Sales context to be the default"

DeleteSessionContext

What it does: Removes a session context. If you delete your default context, another one will automatically become the default.

Parameters:

  • contextId (required) - The ID of the context to remove

Example requests:

  • "Delete my old Project X context"

  • "Remove the context I'm not using anymore"

Example Workflows

Weekly Review

Ask your AI: "Show me my sessions from this week, list all pending todos, and highlight any important items"

What happens: AI uses GetSessions with date filtering, then GetToDos to find action items, and can drill into specific sessions for details.

Meeting Preparation

Ask your AI: "Find all sessions about the Q4 roadmap and summarize the key points"

What happens: AI searches through sessions, uses GetSessionDetails and GetSessionHighlights to gather information, then creates a summary.

Task Management

Ask your AI: "Show me all action items from client meetings this month"

What happens: AI uses GetAllTopics to find the Client Meetings topic, GetTopicSessions to list sessions, then GetSessionToDos for each to compile the list.

Topic Analysis

Ask your AI: "Analyze my Team Standup sessions and identify recurring themes"

What happens: AI finds the topic, retrieves all sessions in it, reads transcripts and highlights, then performs analysis.

Organizing Your Data

Ask your AI: "Create a new topic called Q2 Planning and set up a context for our quarterly reviews"

What happens: AI uses CreateTopic to make the new topic, then CreateSessionContext to set up background information for better meeting analysis.

Privacy and Security

  • OAuth 2.1 with PKCE - Secure industry-standard authentication

  • You control access - Authorize exactly what AI can do with your data

  • Session data is protected - AI can help organize topics and contexts, but cannot delete your meeting recordings or transcripts

  • On-demand only - Data accessed only when you make requests

  • Revoke anytime - You can disconnect AI access at any time from your Hedy settings

Requirements

  • Active Hedy subscription (Pro or Premium)

  • Cloud sync enabled in your Hedy settings

  • An AI assistant that supports MCP (like Claude)

Troubleshooting

AI client doesn't have "Add MCP Server" option

  • Check if your client supports remote MCP servers

  • Update to the latest version

  • Look for MCP settings in preferences

  • Some clients only support local servers and need manual configuration

Authorization fails

  • Ensure you're signed in to Hedy

  • Verify your account is active

  • Clear browser cache and retry

  • Check internet connection

  • Try opening https://api.hedy.bot/mcp/.well-known/oauth-protected-resource to verify server is accessible

AI can't access my data

  • Confirm OAuth authorization completed

  • Verify you have sessions in your Hedy account

  • Check authorization status in AI client settings

  • Try disconnecting and reconnecting

Connection stopped working

  • Access token may have expired—reauthorize

  • If you changed Hedy password, reauthorize

  • Check status.hedy.bot for service issues

  • Remove and re-add the server

Client requires manual OAuth configuration

  • If your client doesn't support automatic discovery, use these settings:

    • Authorization URL: https://api.hedy.bot/mcp/oauth/authorize

    • Token URL: https://api.hedy.bot/mcp/oauth/token

    • Scopes: mcp.sessions.read mcp.highlights.read mcp.todos.read mcp.topics.read mcp.topics.write mcp.contexts.read mcp.contexts.write

AI says a tool failed or returned an error

  • Check that the session/highlight/topic ID is valid

  • Verify you have permission to access that data

  • Ensure the requested data exists in your account

  • Try asking more specifically (e.g., include session titles instead of IDs)

  • Check for rate limiting—wait a moment and retry

Best Practices

For Better Results

  • Use clear session titles - Makes them easier for AI to find

  • Organize with topics - Group related sessions together

  • Create highlights during meetings - Helps AI identify key moments

  • Add descriptive todo notes - Makes action items more searchable

  • Be specific in requests - Include dates, topics, or keywords

When Asking Your AI

  • Specify time ranges - "Show sessions from last week" is clearer than "Show recent sessions"

  • Mention topics when relevant - "Client meeting sessions" vs "all sessions"

  • Ask for summaries - AI can synthesize data from multiple tools

  • Request specific formats - "Create a bullet list" or "Make a table"

  • Follow up with questions - AI can drill deeper into results

Pro tip: The AI can combine multiple tools in one request. Try asking complex questions like "Find all pending todos from client meetings this month and organize them by priority" or "Create a new topic for our product launches and list all sessions that should go in it" to see the power of MCP integration.

Need Help?

  • Check your AI client's MCP documentation for client-specific instructions

  • Visit modelcontextprotocol.io for general MCP information

  • Contact Hedy support with error messages and your AI client name

Related Articles
Welcome to Hedy: Your AI Meeting Coach
Version 2.4 Newsletter
Hedy API
Version 2.10 Newsletter
Webhooks
Did this answer your question?