Skip to main content
Load metadata first, then fetch only the content you need. The examples below show how to combine MCP tools while keeping token usage low.
If this is your first time, read the MCP overview and connect your client.

​
How to Find a Meeting and Read What Was Discussed

Start with list_notes, call search_notes when you need document content, and call get_note_transcript when you need the exact spoken words. Most questions can be answered in the first two steps.

​
Step-by-step

1

List candidate notes (cheapest)

Call list_notes with an optional query.keyword and filter to narrow the result. Returns metadata only (~50 tokens per note).
Use filter.folderId to scope to a specific folder, or omit query.keyword entirely to browse a folder by date.
2

Read documents for matched notes

When you need to understand what was discussed (not just see which notes match), call search_notes with a required keyword. The response carries each matched note’s primary documents (one-pager, custom) inline, HTML-stripped and capped at 5KB per document.
Returns up to 10 matched notes with their documents (~1,500 tokens per note). Most queries end here — the curated documents typically capture the team’s decisions and action items.
3

Fetch a single AI summary (optional)

If you need a summary overview, call get_note with include: ["summary"].
Returns key decisions, action items, and highlights (200–800 tokens).
4

Load the full transcript (last resort)

Only when you need exact quotes or specific spoken words, call get_note_transcript. Returns timestamped paragraphs and a markdown-friendly transcription string (~3,000–5,000 tokens per hour of meeting).

​
Token Usage

​
Frequently Asked Questions

Try broader criteria:
  • Drop or shorten the query.keyword.
  • Widen the filter.createdAtFrom / createdAtTo range or remove it.
  • Verify the note is “Completed” in your Tiro Dashboard — incomplete notes are excluded automatically.
ISO 8601 datetime with timezone: 2026-04-01T00:00:00Z. Date-only formats like 2026-04-01 are not accepted. The range is half-open [from, to).
Yes. list_notes and search_notes support both user-scoped and workspace-scoped API Keys. A workspace-scoped API Key searches only the workspace it is connected to. To target a specific workspace, pass the workspaceGuid you get from list_workspaces.

​
How to Read Structured Documents from Meeting Notes

AI agents can read the template-based documents Tiro has already generated. Each document holds action items, decisions, and key takeaways in the section structure defined by its template.

​
Step-by-step

1

Browse available templates

Call list_document_templates to see what document types are available.
Returns templates like “Meeting Minutes”, “Action Items”, “Decision Log” — each with an id, title, and description.
2

Find the target meeting

Call list_notes to locate the meeting by keyword (or folder, or date range).
3

Retrieve the documents

Call get_note with include: ["documents"] to fetch all generated documents for the note in one call.
Returns all generated documents with their structured sections (e.g., “Decisions”, “Action Items”, “Next Steps”) for the meeting.

​
Frequently Asked Questions

Call list_document_templates first. Each template includes a description field explaining its purpose. Use get_document_template with a specific templateId to see the full section structure before requesting documents.
get_note(include: ["documents"]) returns an empty array. Documents must be generated from the Tiro app first — the MCP server provides read access to existing documents. Ask the note owner to generate the document in Tiro.

​
Tips for AI Agent Developers

​
Reducing Token Usage

  • Use pagination.size to bound results: list_notes defaults to 20 (max 100); search_notes defaults to 10 (max 30, smaller because each result includes documents).
  • Request MARKDOWN format for summaries and documents.

​
Error Handling

  • 401 and 403 responses include action_url and docs_url fields — surface these to you for self-service resolution
  • 429 responses include a Retry-After header — respect it before retrying
  • See Troubleshooting for a full error reference

​
Choosing the Right Tool

Browse the full Tool Reference for the complete tool surface.