How do I install the telldone mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

No required environment variable has been verified for this listing. Check the project’s current configuration instructions; a key shown as an example value is not an environment-variable name.

SSyncDev

Start a project

Telldone MCP Server

TellDone MCP Server - voice-first planning for AI tools

Local serverstdioPython

What is the Telldone MCP Server?

TellDone MCP Server - voice-first planning for AI tools

What it actually does

Connect your TellDone voice notes, tasks, events, and reports to Claude (Desktop, claude.ai, and Code), Cursor, Windsurf, Codex, and any MCP-compatible client — with one-click OAuth (browser sign-in, no token to copy) or a bearer token.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_profile	Returns the authenticated user's profile including display name, email, locale, timezone, subscription plan, and usage statistics (total notes, tasks, events).
get_notes	Lists voice notes with optional filters: date_from/date_to (ISO 8601), tag (string), type (task/idea/info/status/meeting/event/reflection), search (text query),
get_note	Returns a single note by UUID note_id, including full transcription, AI summary, and all linked child tasks and events. Use when you need complete note content
get_notes_full	Bulk retrieval of notes with embedded children (tasks + events). Same filters as get_notes. Use instead of calling get_note in a loop. Returns larger payloads —
get_tasks	Lists tasks with filters: status (todo/done/all, default: todo), tag, priority (low/medium/high), date_from/date_to for deadline range, limit, offset. Returns t
get_events	Lists calendar events with date_from/date_to range filters, status (confirmed/tentative/cancelled), limit, offset. Returns event title, start/end times, locatio
get_reports	Returns AI-generated productivity reports. Filter by period (daily/weekly/monthly/yearly) and date_from/date_to. Reports summarize completed tasks, patterns, an
get_tags	Returns all user-defined tags sorted by usage frequency (most used first). No parameters. Use to discover available tags before filtering notes or tasks.
search	Hybrid text + semantic search across notes, tasks, and events. Parameter: query (string). Combines keyword matching with vector similarity for relevant results
process_note	Runs the full AI analysis pipeline on text or audio input — identical to recording a voice note in the mobile app. Accepts text (string) or audio_base64 + audio
create_note	Creates a plain text note without AI analysis. Parameters: title (required, max 200), summary (max 1000 chars, concise teaser — included in report LLM prompts),
create_task	Creates a task with title (required), description, priority (low/medium/high, default: medium), deadline (ISO 8601 date), reminder_at (ISO 8601 datetime), tags
create_event	Creates a calendar event with title (required), start_at/end_at (ISO 8601 datetime), location, attendees (comma-separated), reminder_minutes (integer), recurren
update_note	Updates note fields by note_id (UUID, required). Optional: title, summary (max 1000), transcript (plan-based limit, long-form body), type, tags, priority, statu
update_task	Updates task fields by task_id (UUID, required). Optional: title, description, priority, deadline, reminder_at, tags, status (todo/done). Use complete_task as a
update_event	Updates event fields by event_id (UUID, required). Optional: title, start_at, end_at, location, attendees, status (confirmed/tentative/cancelled), reminder_minu
complete_task	Marks a task as done by task_id (UUID). Shortcut for update_task with status: "done". Records completion timestamp and source ("mcp").
delete_note	Soft-deletes a note by note_id (UUID). Cascades to all linked child tasks and events — they are also soft-deleted. Reversible from the web app.
delete_task	Soft-deletes a task by task_id (UUID). Does not affect the parent note. Reversible from the web app.
delete_event	Soft-deletes an event by event_id (UUID). Does not affect the parent note. Reversible from the web app.

How to install the Telldone MCP Server

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": {
        "Authorization": "YOUR_AUTHORIZATION"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use Telldone MCP to get profile.”
“Use Telldone MCP to get notes.”
“Use Telldone MCP to get note.”

Frequently asked questions

TellDone MCP Server - voice-first planning for AI tools Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.