Resonant is in beta access — download and start dictating today.
Resonant

Docs / MCP

MCP Setup Guide

Connect your AI tools to Resonant's MCP server. Your meetings, dictations, memos, and work context become queryable tools.

Prerequisites

  • •Resonant installed and running on your Mac (download)
  • •macOS 14+ on Apple Silicon (M1, M2, M3, M4)
  • •An MCP-compatible AI tool (Claude Code, Cursor, VS Code, Windsurf, etc.)

The MCP server starts automatically when Resonant launches. No additional setup is needed on the Resonant side.

Claude Code (auto-discovery)

Claude Code auto-discovers Resonant's MCP server. No configuration required.

Steps

  1. 1. Install and open Resonant
  2. 2. Open Claude Code
  3. 3. Try a query: “What did I dictate today?”

Claude Code will detect Resonant's MCP server and use its tools automatically. You'll see tool calls like search() or get_journal() in Claude's responses.

Cursor (auto-discovery)

Cursor also auto-discovers Resonant's MCP server when both are running.

Steps

  1. 1. Install and open Resonant
  2. 2. Open Cursor
  3. 3. In Cursor's AI chat, ask: “Search my recent dictations for mentions of auth”

VS Code & other MCP clients (manual config)

For VS Code, Windsurf, and other MCP-compatible tools, add Resonant's server to your MCP configuration:

{
  "mcpServers": {
    "resonant": {
      "command": "/Applications/Resonant.app/Contents/Resources/mcp-server",
      "transport": "stdio"
    }
  }
}

Add this to your MCP settings file. The location varies by client:

  • •VS Code: .vscode/mcp.json
  • •Windsurf: ~/.windsurf/mcp.json

Verifying the connection

To confirm the MCP server is working, ask your AI tool any of these:

  • “What Resonant tools are available?”
  • “Show my recent voice activity”
  • “What model is Resonant using?”
  • “Search my dictations for [any keyword]”

If the AI tool responds with data from Resonant (rather than saying it doesn't have access), the connection is working.

Example queries to try

“What did I discuss in my last meeting?”

search → get_meeting

“What was I working on yesterday?”

ambient_timeline

“Find all my dictations about the API redesign”

search

“Show me today's journal”

get_journal

“How many words have I dictated this week?”

get_stats

“What apps did I use most today?”

ambient_app_usage

Troubleshooting

AI tool doesn't see Resonant's tools

Make sure Resonant is running. The MCP server only starts when Resonant is active. Restart your AI tool after launching Resonant.

Queries return empty results

The MCP server queries your local voice workspace. If you just installed Resonant, use it for a day first — dictate, record a meeting, or capture some memos. The tools need data to search.

Manual config not working

Verify the path to the MCP server binary exists: /Applications/Resonant.app/Contents/Resources/mcp-server. If Resonant is installed elsewhere, adjust the path.

Next steps