Skip to main content

​
Overview

Resonant includes a built-in Model Context Protocol (MCP) server. Once connected, your AI tools can search your dictations, query meeting transcripts, browse your journal, and access ambient context — all from natural language prompts. The MCP server starts automatically when Resonant launches. No additional setup is needed on the Resonant side.

​
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.)

​
Claude Code (auto-discovery)

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

Install and open Resonant

2

Open Claude Code

3

Try a query

Ask: “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.
1

Install and open Resonant

2

Open Cursor

3

Try a query

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:
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

​
Troubleshooting

Make sure Resonant is running. The MCP server only starts when Resonant is active. Restart your AI tool after launching Resonant.
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.
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

MCP Tool Reference

Full documentation for all 11 MCP tools with parameters and examples.

Dictation

Learn about voice models, formatting, and dictation settings.