exp78 avatar

Telldone

exp78/telldone-mcp

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 tools

Public 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*secret

Bearer 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 MCPBETA26 after 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.


View the full README on GitHub

Details

Repository
github.com/exp78/telldone-mcp
Category
Mobile Development
Package
telldone-mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active

Related Mobile Development MCP servers

View all
1pipeworx-io avatarPub Devpipeworx-io/mcp-pub-devpub.dev MCP — package registry for Dart & Flutter.0stars
2syncky avatarSyncky Healthsyncky/syncky-openApple Health data, end-to-end encrypted between iPhone and local Syncky agent, allowed write-back0stars
3mobileproxy avatarMcp Servermobileproxy/mcp-serverControl dedicated 4G mobile and residential proxies on mobileproxy.space from AI agents.0stars
4ai avatarRemote Cameramoda.ai/remote-cameraCapture photos remotely from mobile devices via S3-backed upload URLs0stars
5prospeo-v2 avatarProspeo Mcp Serverprospeo-v2/prospeo-mcp-serverProspeo: Find, search, and enrich people and companies with verified emails and mobile numbers.0stars
6thegridwork avatarSiteauditthegridwork/siteauditAudit websites for accessibility, performance, SEO, design, and mobile. 47 WCAG checks.0stars