
Telldone
Hooks Claude into your TellDone voice notes, tasks, and events through 21 tools over streamable HTTP. You can search notes, create and complete tasks with deadlines and priorities, schedule events with reminders and recurrence rules, pull daily productivity reports, and send text through the same AI pipeline that processes voice recordings on iOS and Apple Watch. All datetimes and UUIDs come back as JSON strings, not native types, so you'll need to parse them before doing date math. Write operations return minimal payloads with just id, title, and status, so follow up with the corresponding get tool if you need full records. Useful when you want your editor or AI assistant to read from or write to a voice-first planning system without opening the app.
- tools
- 20
- auth
- Secret needed
- transport
- HTTP
- env var
- 1
- last updated
- Apr 11, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
get_profileReturns the authenticated user's profile including display name, email, locale, timezone, subscription plan, and usage statistics (total notes, tasks, events).
Returns the authenticated user's profile including display name, email, locale, timezone, subscription plan, and usage statistics (total notes, tasks, events).
No parameter schema in public metadata yet.
get_notesLists voice notes with optional filters: date range, tag, type, text search, limit and offset. Returns note metadata without full body.
Lists voice notes with optional filters: date range, tag, type, text search, limit and offset. Returns note metadata without full body.
No parameter schema in public metadata yet.
get_noteReturns a single note by UUID, including full transcription, AI summary, and all linked child tasks and events.
Returns a single note by UUID, including full transcription, AI summary, and all linked child tasks and events.
No parameter schema in public metadata yet.
get_notes_fullBulk retrieval of notes with embedded children (tasks and events), using the same filters as get_notes.
Bulk retrieval of notes with embedded children (tasks and events), using the same filters as get_notes.
No parameter schema in public metadata yet.
get_tasksLists tasks with filters for status, tag, priority, deadline range, limit and offset.
Lists tasks with filters for status, tag, priority, deadline range, limit and offset.
No parameter schema in public metadata yet.
get_eventsLists calendar events with date range and status filters, limit and offset. Returns event title, start/end times, location, attendees and reminders.
Lists calendar events with date range and status filters, limit and offset. Returns event title, start/end times, location, attendees and reminders.
No parameter schema in public metadata yet.
get_reportsReturns AI-generated productivity reports, filtered by period and date range.
Returns AI-generated productivity reports, filtered by period and date range.
No parameter schema in public metadata yet.
get_tagsReturns all user-defined tags sorted by usage frequency. No parameters.
Returns all user-defined tags sorted by usage frequency. No parameters.
No parameter schema in public metadata yet.
searchHybrid text and semantic search across notes, tasks, and events, returning mixed result types with relevance scores.
Hybrid text and semantic search across notes, tasks, and events, returning mixed result types with relevance scores.
No parameter schema in public metadata yet.
process_noteRuns the full AI analysis pipeline on text or audio input, identical to recording a voice note in the mobile app. Returns immediately with audio_id; results arrive asynchronously.
Runs the full AI analysis pipeline on text or audio input, identical to recording a voice note in the mobile app. Returns immediately with audio_id; results arrive asynchronously.
No parameter schema in public metadata yet.
create_noteCreates a plain text note without AI analysis.
Creates a plain text note without AI analysis.
No parameter schema in public metadata yet.
create_taskCreates a task with title, description, priority, deadline, reminder, and tags.
Creates a task with title, description, priority, deadline, reminder, and tags.
No parameter schema in public metadata yet.
create_eventCreates a calendar event with title, start and end times, location, attendees, reminder, recurrence, and status.
Creates a calendar event with title, start and end times, location, attendees, reminder, recurrence, and status.
No parameter schema in public metadata yet.
update_noteUpdates note fields by note_id. Only provided fields are changed.
Updates note fields by note_id. Only provided fields are changed.
No parameter schema in public metadata yet.
update_taskUpdates task fields by task_id. Use complete_task as a shortcut for marking done.
Updates task fields by task_id. Use complete_task as a shortcut for marking done.
No parameter schema in public metadata yet.
update_eventUpdates event fields by event_id.
Updates event fields by event_id.
No parameter schema in public metadata yet.
complete_taskMarks a task as done by task_id. Shortcut for update_task with status done.
Marks a task as done by task_id. Shortcut for update_task with status done.
No parameter schema in public metadata yet.
delete_noteSoft-deletes a note by note_id, cascading to linked child tasks and events. Reversible from the web app.
Soft-deletes a note by note_id, cascading to linked child tasks and events. Reversible from the web app.
No parameter schema in public metadata yet.
delete_taskSoft-deletes a task by task_id. Does not affect the parent note. Reversible from the web app.
Soft-deletes a task by task_id. Does not affect the parent note. Reversible from the web app.
No parameter schema in public metadata yet.
delete_eventSoft-deletes an event by event_id. Does not affect the parent note. Reversible from the web app.
Soft-deletes an event by event_id. Does not affect the parent note. Reversible from the web app.
No parameter schema in public metadata yet.
Sponsors
Configuration
TELLDONE_TOKEN*secretBearer token from app.telldone.app -> Settings -> AI Agents (MCP)
Readme
TellDone MCP Server
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.
TellDone is a voice-first planning app. Dictate your thoughts, and AI automatically creates structured notes, tasks, events, and daily productivity reports.
Voice recording is available on iOS and Apple Watch. Android coming soon. You can also send text through MCP using process_note for the same AI analysis pipeline.
Use promo code
MCPBETA26after signup to get free MCP access (read & write for 30 days, then read-only for a year).
Quick Start
Connect in one of two ways: one-click OAuth (recommended — browser sign-in, nothing to copy) or a bearer token (works with every MCP client).
Option A — One-click OAuth · Claude Desktop, claude.ai, Claude Code
Add TellDone as a connector, sign in to your account in the browser, and approve. Access tokens are short-lived, scope-limited, and revocable any time in Settings — there's nothing to copy or store.
Details
- Repository
- github.com/exp78/telldone-mcp
- Category
- Mobile Development
- Package
telldone-mcp- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active