Resonant

MCP Tool Reference

Complete documentation for all 11 MCP tools. Each tool is callable by any MCP-compatible AI assistant.

recent_activity

Returns a feed of recent voice activity — dictations, memos, meetings — ordered by time.

ParameterTypeReqDescription
limitnumberNoMax items to return (default: 20)
typestringNoFilter by type: "dictation", "meeting", "memo", or "all"

Example query

"What have I been working on today?"

Response format

Returns array of recent items with id, type, text preview, timestamp, and app context.

get_journal

Retrieves the auto-generated daily journal for a specific date. Includes timeline, highlights, and task blocks grouped by app.

ParameterTypeReqDescription
datestringNoDate to retrieve (ISO 8601). Defaults to today.

Example query

"Show me yesterday's journal"

Response format

Returns journal object with date, timeline entries, highlights, task blocks, and word count.

ambient_timeline

Returns the ambient context timeline — a chronological record of app switches, window titles, URLs, and dwell time.

ParameterTypeReqDescription
datestringNoDate to query (default: today)
startstringNoStart time filter (HH:MM)
endstringNoEnd time filter (HH:MM)

Example query

"What was I doing between 2pm and 4pm?"

Response format

Returns array of timeline entries with app, window title, URL, start time, end time, and duration.

ambient_app_usage

Aggregated app usage statistics from ambient context. Shows which apps you used, for how long, and when.

ParameterTypeReqDescription
datestringNoDate to query (default: today)
startstringNoStart time filter (HH:MM)
endstringNoEnd time filter (HH:MM)

Example query

"How much time did I spend in Slack today?"

Response format

Returns array of app objects with name, total duration, session count, and time-of-day breakdown.

get_dictation

Retrieves a specific dictation by ID with full metadata.

ParameterTypeReqDescription
idstringYesDictation ID

Example query

"Get the details of that dictation I did in VS Code"

Response format

Returns dictation object with raw transcript, cleaned text, app, window title, URL, duration, and timestamp.

get_meeting

Retrieves a full meeting transcript with speaker labels, timestamps, and meeting metadata.

ParameterTypeReqDescription
idstringYesMeeting ID

Example query

"Pull the transcript from my 10am meeting"

Response format

Returns meeting object with transcript lines (speaker, text, timestamp), total duration, app, and participant count.

get_memo

Retrieves a voice memo with its auto-generated title, AI summary, transcript, and metadata.

ParameterTypeReqDescription
idstringYesMemo ID

Example query

"Find that memo about the API redesign"

Response format

Returns memo object with title, summary, transcript, duration, and timestamp.

get_stats

Returns voice workspace statistics — word counts, dictation counts, streaks, and progression.

ParameterTypeReqDescription
periodstringNo"today", "week", "month", or "all" (default: "all")

Example query

"How many words have I dictated this week?"

Response format

Returns stats object with total words, dictation count, meeting hours, streak days, and progression level.

get_context

Returns the current ambient context snapshot — what's on screen right now.

No parameters.

Example query

"What am I looking at right now?"

Response format

Returns context object with active app, window title, URL, selected text, and visible text snippets.

get_config

Returns the current Resonant configuration.

No parameters.

Example query

"What model is Resonant using?"

Response format

Returns config object with active model, language, trigger key, cloud cleanup status, and enabled features.