AI agenti (MCP)
MCP radi na svim planovima. Free i Basic dobivaju pristup samo za čitanje svim 10 alata za čitanje (Free je ograničen na 100 zahtjeva dnevno). Pro i Ultra dobivaju potpun pristup Čitanje i pisanje (27 alata) i mogu prijeći na način samo za čitanje ako žele.
MCP (Model Context Protocol) omogućuje da AI asistente poput ChatGPT-a i Claudea, asistente za programiranje i alate za automatizaciju povežeš izravno sa svojim TellDone podacima. Kad se poveže, tvoj asistent može čitati tvoje bilješke, zadatke, događaje, izvješća, oznake i povijest promjena. Od plana Pro može i stvarati, ažurirati, brisati i vraćati stavke. Ukupno je 27 alata: 10 za čitanje (svaki plan) i 17 za pisanje (od plana Pro).
Na iPhoneu Postavke > Integracije > AI agenti (MCP) otvara zaslon za postavljanje MCP-a, s pristupnim tokenom koji je prema zadanim postavkama skriven:
A na webu:
Dva načina povezivanja
AI klijent možeš povezati na dva načina:
- Prijava putem TellDonea (OAuth) (preporučeno) - prijaviš se svojim TellDone računom i odobriš ono što aplikacija traži. ChatGPT i Claude koriste ovo i nema tokena za kopiranje.
- Bearer token - kopiraj svoj pristupni token iz Postavki i zalijepi ga u konfiguraciju svog klijenta. Najjednostavnije za skripte, alate naredbenog retka i klijente koji nemaju ugrađen OAuth tijek.
| Klijent | Preporuka |
|---|---|
| ChatGPT (chatgpt.com ili desktop aplikacija ChatGPT, ne mobilna aplikacija) | OAuth - dodaj prilagođeni MCP poslužitelj s MCP URL-om, zatim se prijavi |
| Claude (web, Desktop, iPhone aplikacija) / Cowork | OAuth - dodaj prilagođeni konektor s MCP URL-om, zatim se prijavi |
| Claude Code (CLI) | Za sada Bearer token - dodaj zaglavlje Authorization sa svojim tokenom |
| Skripte ili tvoj vlastiti kod | Bearer token - najjednostavnije za automatizaciju |
| Klijent koji dopušta samo odabir s direktorija navedenih konektora | Dodaj TellDone kao prilagođeni konektor s MCP URL-om ili upotrijebi bearer token. TellDone još nije ni u jednom direktoriju konektora |
Zahtjevi plana
| Plan | MCP |
|---|---|
| Free | Samo čitanje (10 alata za čitanje), 100 zahtjeva dnevno |
| Basic | Samo čitanje (10 alata za čitanje), bez dnevnog ograničenja |
| Pro | Čitanje i pisanje (27 alata) - može prijeći na način Samo za čitanje |
| Ultra | Čitanje i pisanje (27 alata) - može prijeći na način Samo za čitanje |
Ograničenje od 100 zahtjeva dnevno na planu Free broji samo pozive alata. Povezivanje, prijava i ispis alata ne računaju se. Dan se računa prema vremenskoj zoni spremljenoj u tvom računu i resetira se u ponoć. Kad dosegneš ograničenje, tvoj asistent dobiva poruku o tome. Alati za pisanje odbijaju se na planovima Free i Basic. S pristupnim tokenom odgovaraju da je veza samo za čitanje i da stvaranje i uređivanje traži plan Pro ili viši. S prijavom (OAuth) većina odgovara "Insufficient scope", jer veze na planovima Free i Basic nikad ne dobivaju dozvole za pisanje.
Zaslon u aplikaciji
Otvori Postavke > Integracije, a u odjeljku AI agenti dodirni AI agenti (MCP). Zaslon kaže "Neka ChatGPT, Claude i drugi AI asistenti rade s tvojim TellDone bilješkama, zadacima i događajima." i prikazuje tvoj plan:
- Free: "Tvoj plan: pristup samo za čitanje, 100 zahtjeva dnevno. Pisanje dolazi uz plan Pro."
- Basic: "Tvoj plan: pristup samo za čitanje"
- Pro i Ultra: "Tvoj plan: pristup za čitanje i pisanje"
Dok je MCP isključen, dodirni Omogući da ga uključiš.
Kad je omogućen, zaslon prikazuje:
- Način pristupa (Pro i Ultra) - u bilo kojem trenutku odaberi Samo za čitanje ili Čitanje i pisanje.
- Poveži asistenta - koraci za ChatGPT, Claude i Drugi asistent. U TellDone se prijavljuješ unutar asistenta, pa token nije potreban.
- Povezane aplikacije - asistenti koje si povezao, svaki s gumbom Prekini vezu. Prazno je do prvog povezivanja.
- Za programere (prema zadanim postavkama sažeto) - polje Pristupni token (skriveno, s Prikaži / Sakrij i Kopiraj), Regeneriraj token i prekidač Claude Code / Cursor / Other s gotovim tekstom i vlastitim gumbom Kopiraj. Claude Code daje naredbu
claude mcp add, Cursor daje JSON za.cursor/mcp.json, a Other navodi adresu poslužitelja, mogućnost OAuth prijave i zaglavljeAuthorization: Bearer. Dok je token skriven, isječci prikazujuYOUR_TOKEN. Dodirni Prikaži i sadržavat će tvoj pravi token.
Web ima iste kontrole u drugačijem rasporedu, bez sažetog odjeljka za programere: OAuth adresu s gumbom Kopiraj, kontrole tokena, Povezane aplikacije s Prekini vezu i Ručno postavljanje bearer tokena sa šest izbora klijenta (Claude Code, Cursor, Windsurf, Codex, OpenClaw i cURL). Na webu isječci uvijek sadrže tvoj pravi token, čak i dok je polje tokena skriveno, zato ih čuvaj kao sam token.
- Dokumentacija - poveznica na ovu stranicu.
- Onemogući - isključuje MCP. Potvrđuješ s "Ovime će se opozvati pristup svim povezanim AI alatima." Tvoj token se briše i sve veze prestaju. Ako ponovno omogućiš MCP, dobiješ novi token, a aplikacije povezane prijavom (OAuth) ponovno rade bez nove prijave. Da aplikaciju trajno ukloniš, dodirni Prekini vezu pod Povezane aplikacije.
Čuvaj svoj pristupni token privatnim. Svatko s tokenom može pristupiti tvojim TellDone podacima. Dodirni Regeneriraj token ako ikad posumnjaš da je procurio.
Kako omogućiti
MCP možeš postaviti na obje platforme:
- iPhone: Postavke > Integracije > AI agenti (MCP)
- Web: app.telldone.app > Postavke > Integracije > AI agenti (MCP)
Koraci:
- Dodirni Omogući.
- Na planovima Pro i Ultra odaberi način pristupa (Samo za čitanje ili Čitanje i pisanje). Free i Basic su samo za čitanje.
- Za povezivanje ChatGPT-a ili Claudea dodirni ga pod Poveži asistenta i slijedi korake (vidi niže). Token nije potreban.
- Za klijent za programiranje na iPhoneu otvori Za programere, dodirni Prikaži, odaberi Claude Code, Cursor ili Other i dodirni Kopiraj ispod isječka. Ako kopiraš prije dodirivanja Prikaži, isječak ima
YOUR_TOKENumjesto tvog tokena. Na webu odaberi svoj klijent pod Ručno postavljanje bearer tokena i kopiraj isječak; on već sadrži tvoj token. - Zalijepi isječak u svoj klijent ili njegovu konfiguracijsku datoteku.
Povezivanje putem OAuth-a
OAuth je preporučeni put za ChatGPT, Claude i Cowork - prijavljuješ se svojim TellDone računom umjesto kopiranja tokena.
MCP URL za OAuth: https://api.telldone.app/mcp/user
Isti poslužitelj odgovara i na https://api.telldone.app/mcp/user/mcp, a obje adrese prihvaćaju bearer token. Za OAuth prijavu upotrijebi prvu.
ChatGPT
Prilagođeni MCP poslužitelj možeš dodati na chatgpt.com ili u desktop aplikaciji ChatGPT. Mobilna aplikacija ChatGPT ne može dodavati prilagođene konektore, a aplikacija TellDone to kaže ovako: "Aplikacija ChatGPT dodaje konektore samo iz svojeg kataloga." Dodirni Pošalji upute na moje računalo u TellDoneu da dobiješ upute na računalu. Kad ga jednom dodaš tamo, TellDone je dostupan i u mobilnoj aplikaciji ChatGPT.
Koraci u aplikaciji:
- Na računalu otvori chatgpt.com/plugins, klikni Add i odaberi Add custom MCP server.
- Nazovi ga TellDone, zalijepi adresu ispod (
https://api.telldone.app/mcp/user) i odaberi OAuth. - Potvrdi i instaliraj ga, zatim se prijavi u TellDone i dopusti pristup.
Ako se nazivi izbornika promijene, pogledaj OpenAI-jev vodič o prilagođenim MCP poslužiteljima.
Claude (web, Desktop, iPhone aplikacija) / Cowork
Koraci u aplikaciji:
- U Claudeu otvori Customize → Connectors i dodirni Add custom connector.
- Zalijepi adresu ispod (
https://api.telldone.app/mcp/user). - Prijavi se u TellDone i dopusti pristup.
Pri prijavi TellDoneova stranica za pristanak prikazuje koja aplikacija traži pristup i točne dozvole koje želi. Prijavi se svojom TellDone e-poštom i lozinkom i klikni Allow access ili dodirni Sign in with Apple odnosno Sign in with Google, što odobrava pristup u istom koraku. Claude se povezuje sam - nema tokena za kopiranje.
Ako se nazivi izbornika promijene, pogledaj Anthropicov vodič o dodavanju prilagođenog konektora.
Povezivanje bearer tokenom
Za Claude Code, Cursor i druge klijente bez ugrađene OAuth prijave zalijepi svoj pristupni token izravno u konfiguraciju klijenta. U svim primjerima ispod zamijeni YOUR_TOKEN tokenom iz svojih postavki.
Claude Code (bearer token)
claude mcp add --transport http telldone \
https://api.telldone.app/mcp/user/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Ne moraš ovo upisivati sam: u Postavke > Integracije > AI agenti (MCP) > Za programere dodirni Prikaži, odaberi Claude Code i dodirni Kopiraj. Kopirana naredba već sadrži tvoj token.
Cursor
Dodaj u .cursor/mcp.json (ili kopiraj iz Za programere > Cursor nakon dodirivanja Prikaži):
{
"mcpServers": {
"telldone": {
"url": "https://api.telldone.app/mcp/user/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Drugi klijenti
Postavke za druge MCP klijente:
Codex
Dodaj u codex.json:
{
"mcpServers": {
"telldone": {
"type": "http",
"url": "https://api.telldone.app/mcp/user/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
OpenClaw
Settings > MCP Servers > Add:
- Name:
TellDone - URL:
https://api.telldone.app/mcp/user/mcp - Auth:
Bearer YOUR_TOKEN
Drugi MCP klijenti
Povezati se može svaki alat koji podržava MCP preko HTTP-a. Upotrijebi krajnju točku https://api.telldone.app/mcp/user/mcp sa zaglavljem autorizacije Bearer YOUR_TOKEN.
Ako tvoj klijent ili proxy rezervira zaglavlje Authorization (na primjer, neki pristupnici u stilu Smitheryja), pošalji token u X-MCP-Token: YOUR_TOKEN. Oba zaglavlja rade; ako su prisutna oba, prednost ima Authorization.
Testiranje veze
Možeš provjeriti radi li tvoj token jednostavnom cURL naredbom:
curl -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
Uspješan odgovor navodi sve dostupne alate.
Dozvole (scope-ovi)
OAuth veze imaju ograničene dozvole - pri prijavi vidiš što točno klijent traži i to izričito odobravaš.
| Scope | Dopušta aplikaciji da... |
|---|---|
notes:read | Čita tvoje bilješke i otvara pune pojedinosti bilješke (alat za pretraživanje treba i tasks:read i events:read) |
notes:write | Stvara, uređuje i briše bilješke (process_note treba i tasks:write i events:write) |
tasks:read / tasks:write | Čita / stvara, uređuje, dovršava i briše zadatke |
events:read / events:write | Čita / stvara, uređuje i briše događaje |
reports:read | Čita tvoja dnevna, tjedna, mjesečna i godišnja izvješća |
tags:read / tags:write | Ispisuje tvoje oznake / stvara, prikvačuje, briše i vraća oznake |
profile:read | Čita podatke o tvom računu i pretplati |
offline_access | Ostaje prijavljena (izdaje refresh token pa se ne moraš prijavljivati iznova u svakoj sesiji) |
Scope-ovi ograničavaju što veza može: veza samo s notes:read ne može pozvati alat za pisanje. Tvoj plan postavlja drugo ograničenje povrh toga.
Veze s bearer tokenom nemaju pojedinačne scope-ove - njima upravlja samo način čitanja/pisanja tvog plana.
Što možeš raditi
Alati za čitanje (10) - svi planovi
| Alat | Što radi |
|---|---|
| get_notes | Ispisuje bilješke s filtrima (oznake, raspon datuma, pretraživanje teksta) |
| get_note | Prikazuje jednu bilješku s njezinim podređenim zadacima, događajima i cijelim transkriptom |
| get_notes_full | Dohvaća više bilješki s ugrađenim zadacima i događajima u jednom pozivu |
| get_tasks | Ispisuje zadatke filtrirane po statusu (za obaviti, gotovo, svi), oznakama ili datumima |
| get_events | Ispisuje događaje u kalendaru, filtrira po rasponu datuma |
| get_reports | Čita tvoja dnevna, tjedna, mjesečna i godišnja izvješća (cijeli markdown) |
| get_tags | Prikazuje sve tvoje oznake poredane po korištenju |
| get_profile | Prikazuje podatke o tvom računu i koliko bilješki, zadataka i događaja imaš |
| search | Pretražuje bilješke, zadatke i događaje (tekst + semantičko pretraživanje bilješki) |
| get_change_log | Prikazuje povijest izmjena bilješke, zadatka ili događaja i je li svaka izmjena poništena |
Alat search podržava semantičko pretraživanje bilješki - pronalazi rezultate prema značenju, a ne samo prema ključnim riječima. Na primjer, pretraživanje "sastanci o proračunu" pronaći će bilješke o financijskim raspravama čak i ako ne sadrže riječ "proračun".
Alati za pisanje (17) - Pro i Ultra
| Alat | Što radi |
|---|---|
| process_note | Cijeli AI tijek - pošalji tekst ili zvuk i dobij bilješku sa zadacima, događajima i oznakama |
| create_note | Dodaje običnu tekstualnu bilješku (bez AI analize) |
| create_task | Dodaje zadatak s prioritetom, rokom, podsjetnikom i oznakama |
| create_event | Dodaje događaj u kalendar s datumom, vremenom, lokacijom, podsjetnicima, sudionicima i pravilom ponavljanja |
| update_note | Mijenja naslov, sažetak, vrstu, oznake, prioritet ili status bilješke |
| update_task | Mijenja naslov, opis, prioritet, rok, podsjetnik, oznake ili status zadatka |
| complete_task | Označava zadatak kao gotov |
| update_event | Mijenja pojedinosti događaja, vrijeme, lokaciju, podsjetnike, sudionike, pravilo ponavljanja, oznake ili status |
| delete_note | Briše bilješku. Njezini zadaci i događaji ostaju |
| delete_task | Briše zadatak |
| delete_event | Briše događaj |
| undo_change_log_entry | Poništava jednu praćenu izmjenu - AI-jevu ili tvoju - vraćajući prijašnju vrijednost polja |
| restore_entity | Vraća izbrisanu ili arhiviranu bilješku ili zadatak, odnosno izbrisan ili otkazan događaj |
| create_tag | Stvara novu oznaku ili automatski predloženu oznaku pretvara u trajnu |
| set_tag_pinned | Prikvačuje ili otkvačuje oznaku da se poreda na vrh |
| delete_tag | Uklanja oznaku (može se vratiti pomoću restore_tag) |
| restore_tag | Vraća izbrisanu oznaku |
Sve operacije pisanja i brisanja odmah se pojavljuju na tvojim povezanim uređajima (telefon, web aplikacija).
Referenca alata
get_notes
List notes with optional filtering. Date filters use recorded_at (when you recorded the voice note), or created_at for a note that has none.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 20 | Number of notes to return (max 50) |
offset | int | 0 | Skip this many notes (for pagination, max 10000) |
tags | string | - | Filter by tags, comma-separated (matches any) |
search | string | - | Text search on title and summary |
date_from | string | - | Start date, YYYY-MM-DD (inclusive) |
date_to | string | - | End date, YYYY-MM-DD (exclusive) |
standalone_only | bool | false | When true, hides follow-up notes (notes attached to a parent note/task/event) and returns only standalone notes |
Returns: list of notes with id, title, summary, type, tags, priority, status, recorded_at, created_at.
get_note
Get a single note with its full transcript and all linked tasks and events.
| Parameter | Type | Description |
|---|---|---|
note_id | string | The note's UUID |
Returns: note with title, summary, transcript, type, tags, priority, status, metadata, created_at, plus tasks[] and events[] arrays.
Also returns transcript_speakers (speaker-labeled transcript turns, for meetings with several speakers - null otherwise), speaker_count (null unless the recording was split by speaker), and parent_note_id/parent_task_id/parent_event_id (set when this note is a follow-up edit of another item). Each tasks[]/events[] entry also includes reminders_at/recurrence_rule (tasks) or reminder_minutes/attendees/recurrence_rule (events).
get_notes_full
Get multiple notes with their tasks and events in a single call. Same filters as get_notes except search, and each note includes embedded tasks[] and events[].
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 10 | Number of notes (max 20) |
offset | int | 0 | Skip this many notes |
tags | string | - | Filter by tags |
date_from | string | - | Start date, YYYY-MM-DD |
date_to | string | - | End date, YYYY-MM-DD |
standalone_only | bool | false | When true, hides follow-up notes (notes attached to a parent note/task/event) and returns only standalone notes |
get_tasks
List tasks with filtering.
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | "todo" | Filter: todo, done, or all |
limit | int | 30 | Number of tasks (max 100) |
offset | int | 0 | Skip this many tasks |
tags | string | - | Filter by tags, comma-separated |
date_from | string | - | Start date, YYYY-MM-DD (filters by deadline; tasks without a deadline are excluded) |
date_to | string | - | End date, YYYY-MM-DD (filters by deadline; tasks without a deadline are excluded) |
Returns: list of tasks with id, title, description, status, priority, tags, deadline, reminder_at, reminders_at, completed_at, completed_by, source, created_at. reminder_at mirrors the first entry of reminders_at for backward compatibility - use reminders_at to see all of a task's reminders.
get_events
List calendar events with date range filtering.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 30 | Number of events (max 100) |
offset | int | 0 | Skip this many events |
date_from | string | - | First day, YYYY-MM-DD, in your own time zone (inclusive). Events that overlap the range are included, so a multi-day event shows on every day it covers |
date_to | string | - | Last day, YYYY-MM-DD, in your own time zone (inclusive) |
Returns: list of events with id, title, description, status, start_at, end_at, location, is_all_day, tags, note_id, reminder_minutes, attendees, recurrence_rule, created_at.
get_reports
Get your AI-generated reports with full markdown content.
| Parameter | Type | Default | Description |
|---|---|---|---|
report_type | string | "daily" | Type: daily, weekly, monthly, or yearly |
limit | int | 5 | Number of reports (max 10) |
Returns: list of reports with id, type, period_start, period_end, content_md, created_at.
Monthly reports are long (often well over 1,000 words). Use limit=1 if your AI tool has a tight context window.
get_tags
Get all your tags, sorted by pinned first, then by usage count.
No parameters. Returns up to 100 tags, each with tag, usage_count, is_pinned, is_manual.
get_profile
Get your account info and how many notes, tasks and events you have.
No parameters. Returns email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at, and stats (note/task/event counts).
search
Search across notes, tasks, and events at once. For notes, supports both text search and semantic search (finds results by meaning using AI embeddings).
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Search text (max 500 characters) |
limit | int | 20 | Max results per type (max 20) |
semantic | bool | true | Enable semantic search for notes |
Returns results grouped by type: notes[], tasks[], events[]. Each result has id, type, title, detail, created_at.
Set semantic=false for faster text-only search.
get_change_log
See the edit history of a note, task, or event - every AI-made follow-up edit and every manual edit you made yourself, newest first.
| Parameter | Type | Default | Description |
|---|---|---|---|
entity | string | required | notes, tasks, or events |
entity_id | string | required | The item's UUID |
include_manual | bool | false | Also include your own manual edits, not just AI-made ones |
Returns: list of change entries with id (use this as entry_id for undo), field_name, old_value, new_value, source (follow_up, smart_context, correction_sync for a name fix TellDone carried across a note, or manual), origin_note_id, edited_at, and reverted_at (set once undone).
process_note (Pro and Ultra)
Full AI pipeline - works the same as recording in the app. Send text or audio, and TellDone will transcribe, analyze with AI, and create a structured note with extracted tasks, events, tags, and embeddings.
This tool is asynchronous: it returns immediately with an audio_id and processes in the background. Results arrive via real-time sync to your connected devices, or you can poll with get_notes().
| Parameter | Type | Description |
|---|---|---|
text | string | Required. Text to analyze. If it is not empty, it is used as the transcript and any audio you send is not transcribed; send "" to have the audio transcribed. Limit when no audio is sent: Pro 20,000 / Ultra 50,000 characters |
audio_base64 | string | Base64-encoded audio file. The whole request is limited to 10 MB, so the audio itself can be about 7 MB. It is transcribed only when text is empty |
audio_format | string | m4a, ogg, wav, mp3, aac, or webm (default: m4a) |
parent_task_id | string | UUID of a task this is a follow-up to |
parent_note_id | string | UUID of a note this is a follow-up to |
parent_event_id | string | UUID of an event this is a follow-up to |
Always send text. To have TellDone transcribe audio, send audio_base64 with text set to an empty string (""). If text is not empty, TellDone uses it as the transcript and does not transcribe the audio. Set at most one of the three parent IDs.
Returns: {"audio_id": "...", "status": "processing", "mode": "text-only"} or "mode": "audio+stt" if audio was provided.
process_note is subject to your plan's quotas (uploads per day, notes per month, max text length). get_profile shows only how many notes, tasks and events you have, not your limits. Check your usage in the app under Settings > Usage.
create_note (Pro and Ultra)
Create a plain text note instantly. Does not trigger AI analysis - no tasks or events are extracted. Use process_note when you want TellDone to find tasks and events for you.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 chars | Required |
summary | string | 1000 chars | Optional. Short teaser (1-3 sentences). Used in your reports, so keep it short |
transcript | string | plan-based | Optional. Long-form body shown in the note detail. Not included in reports. Limits: Pro 20,000 / Ultra 50,000 chars |
type | string | - | Optional. task, idea, info (default), status, meeting, event, or reflection |
tags | string | 20 tags | Comma-separated, optional |
suppress_external_sync | boolean | - | Optional, default false. Set true for imported or bulk items: the item is then not sent to your connected apps or automations |
create_task (Pro and Ultra)
Create a new task. The task is also created in your connected Todoist, Notion or Microsoft To Do, and your automations receive task.created. This does not happen when you pass suppress_external_sync: true.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 chars | Required |
description | string | 2000 chars | Optional |
priority | string | - | low, medium (default), or high |
deadline | string | - | YYYY-MM-DD, optional |
reminder_at | string | - | ISO 8601 datetime (for example 2026-04-15T09:00:00Z), optional |
tags | string | 20 tags | Comma-separated, optional |
note_id | string | - | UUID to link task to a parent note, optional |
suppress_external_sync | boolean | - | Optional, default false. Set true for imported or bulk items: the item is then not sent to your connected apps or automations |
create_event (Pro and Ultra)
Create a calendar event. The event is also created in your connected Notion, and your automations receive calendar_event.created. This does not happen when you pass suppress_external_sync: true.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 chars | Required |
start_at | string | - | ISO 8601 datetime, required |
end_at | string | - | ISO 8601 datetime (default: start + 1 hour; for an all-day event, one day) |
description | string | 2000 chars | Optional |
location | string | 200 chars | Optional |
is_all_day | bool | - | Default: false |
tags | string | 20 tags | Comma-separated, optional |
reminder_minutes | string | - | Comma-separated minutes before event (for example 15,60), optional |
attendees | string | - | Comma-separated names or emails, optional |
recurrence_rule | string | - | RRULE string (for example FREQ=WEEKLY;BYDAY=MO,WE,FR), optional. Rules more frequent than hourly, or that can never happen, are refused |
note_id | string | - | UUID to link event to a parent note, optional |
suppress_external_sync | boolean | - | Optional, default false. Set true for imported or bulk items: the item is then not sent to your connected apps or automations |
update_note (Pro and Ultra)
Update one or more fields on an existing note. Only fields you provide are changed. This works exactly like editing the note in the app: its title, summary, tags and type reach its Notion page, your automations receive note.updated, and the edit appears in the history, where it can be undone. A transcript change is saved and sent to Notion too, but is not in the history.
| Parameter | Type | Description |
|---|---|---|
note_id | string | Required, the note's UUID |
title | string | New title (max 200 chars) |
summary | string | New summary (max 1000 chars, pass a space " " to clear) |
transcript | string | New transcript (plan-based limit, pass a space " " to clear) |
type | string | task, idea, info, status, meeting, event, or reflection |
tags | string | Comma-separated tags (replaces all existing tags, max 20) |
priority | string | low, medium, or high |
status | string | active or archived |
For notes created by the voice pipeline, transcript is the original speech-to-text output. Overwriting it replaces your original words. To keep them, add to the transcript instead of replacing it.
update_task (Pro and Ultra)
Update one or more fields on an existing task. Only fields you provide are changed. This works exactly like editing the task in the app: the change reaches its copies in Todoist, Notion and Microsoft To Do, your automations receive task.updated, and the edit appears in the task's history, where it can be undone. Setting status to done completes it like complete_task. A deadline can be a date or a full date and time (its date is used). Each tag can be up to 50 characters.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Required, the task's UUID |
title | string | New title |
description | string | New description (pass a space " " to clear) |
priority | string | low, medium, or high |
deadline | string | YYYY-MM-DD. This tool can't clear a deadline; clear it in the app |
status | string | todo or done |
tags | string | Comma-separated tags (replaces all existing tags, max 20) |
reminder_at | string | ISO 8601 datetime (pass a space to clear) |
Setting status to done also records when and how the task was completed.
complete_task (Pro and Ultra)
Shortcut to mark a task as done.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Required, the task's UUID |
Returns an error if the task doesn't exist or is already completed.
update_event (Pro and Ultra)
Update one or more fields on an existing event. Only fields you provide are changed. This works exactly like editing the event in the app: the change reaches its Notion page, your automations receive calendar_event.updated, and the edit appears in the history, where it can be undone.
| Parameter | Type | Description |
|---|---|---|
event_id | string | Required, the event's UUID |
title | string | New title |
description | string | New description (pass a space to clear) |
start_at | string | New start time (ISO 8601) |
end_at | string | New end time (ISO 8601) |
location | string | New location (pass a space to clear) |
status | string | confirmed, tentative, or cancelled |
tags | string | Comma-separated tags (replaces all existing tags, max 20) |
is_all_day | string | "true" or "false" |
reminder_minutes | string | Comma-separated minutes before event (for example 15,60, pass a space to clear) |
attendees | string | Comma-separated names or emails (pass a space to clear) |
recurrence_rule | string | RRULE string (pass a space to clear) |
delete_note (Pro and Ultra)
Delete a note. Only the note is deleted: its tasks and events stay. This works exactly like deleting it in the app: your automations receive note.deleted. A copy of the note in Notion is not removed (the app does not remove it either).
| Parameter | Type | Description |
|---|---|---|
note_id | string | Required, the note's UUID |
delete_task (Pro and Ultra)
Delete a task. This works exactly like deleting it in the app: its copies in Todoist, Notion and Microsoft To Do are deleted too, and your automations receive task.deleted. Bring it back with restore_entity.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Required, the task's UUID |
delete_event (Pro and Ultra)
Delete an event. This works exactly like deleting it in the app: your automations receive calendar_event.deleted. The event's page in Notion is not removed (the app does not remove it either).
| Parameter | Type | Description |
|---|---|---|
event_id | string | Required, the event's UUID |
undo_change_log_entry (Pro and Ultra)
Undo a single tracked edit - restores the field to its value before that edit, whether the edit was made by the AI (from a follow-up recording) or by you directly.
| Parameter | Type | Description |
|---|---|---|
entity | string | Required, notes, tasks, or events |
entity_id | string | Required, the item's UUID |
entry_id | string | Required, the change entry's id from get_change_log |
Returns: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Undoing the same entry twice returns an error - it's already undone.
restore_entity (Pro and Ultra)
Bring back a deleted or archived note or task, or a deleted or canceled event.
| Parameter | Type | Description |
|---|---|---|
entity | string | Required, notes, tasks, or events |
entity_id | string | Required, the item's UUID |
Returns: the restored item as JSON.
create_tag (Pro and Ultra)
Create a new tag, or turn an existing auto-suggested tag into a permanent one.
| Parameter | Type | Description |
|---|---|---|
tag | string | Required, 1-50 characters (stored lowercase) |
category | string | Optional |
set_tag_pinned (Pro and Ultra)
Pin or unpin a tag so it sorts to the top of your tag list.
| Parameter | Type | Description |
|---|---|---|
tag | string | Required |
pinned | bool | Required |
Tags containing a / character can't be pinned.
delete_tag (Pro and Ultra)
Remove a tag. Can be brought back with restore_tag.
| Parameter | Type | Description |
|---|---|---|
tag | string | Required |
restore_tag (Pro and Ultra)
Bring back a deleted tag.
| Parameter | Type | Description |
|---|---|---|
tag | string | Required |
Ograničenja unosa
| Field | Max length | Used in |
|---|---|---|
| title | 200 characters | create/update note, task, event |
| description | 2,000 characters | create/update task, event |
| summary | 1,000 characters (hard) | create/update note. Used in your reports, so keep it short |
| transcript | plan-based: Pro 20,000 / Ultra 50,000 | create/update note. Long-form body, not in reports |
| text | plan-based: Pro 20,000 / Ultra 50,000 (when no audio is sent) | process_note |
| location | 200 characters | create/update event |
| tags | 20 tags | create/update note, task, event |
| search query | 500 characters | search |
| audio_base64 | about 7 MB of audio (the whole request is limited to 10 MB) | process_note |
Ako prekoračiš ograničenje, alat vraća poruku o pogrešci poput "title too long (max 200 chars, got 250)".
Rukovanje pogreškama
Većina alata vraća pogreške kao JSON:
{"error": "description of what went wrong"}
Pogreške plana, scope-a i ograničenja unosa vraćaju se kao pogreška alata s istom porukom.
Česte pogreške:
| Error | When |
|---|---|
"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan." | Write tool called in read-only mode (Free and Basic, or Pro and Ultra switched to read-only) |
"Daily limit reached: the Free plan includes 100 TellDone requests a day..." | Free plan used up its 100 requests for the day |
"Daily limit reached (N/M today)" | You created as many items through AI assistants today as your plan allows (process_note, create_note, create_task and create_event each count) |
"Notes limit reached (X/Y this month)" | Your plan's monthly note limit is used up |
"Invalid note_id format" | Non-UUID string passed as ID |
"Note not found" | ID doesn't exist or belongs to another user |
"Task not found or already completed" | complete_task on non-existent or already done task |
"title too long (max 200 chars, got N)" | Input limit exceeded |
"Too many tags (max 20)" | More than 20 tags provided |
Pogreške na razini HTTP-a:
| Code | Meaning |
|---|---|
| 401 | Invalid, revoked or deleted token (disabling MCP deletes your token, and regenerating replaces it) |
| 429 | Rate limit exceeded (5 req/s, burst up to 20) |
Na planu Free dosezanje ograničenja od 100 zahtjeva dnevno prijavljuje se kao poruka o pogrešci alata (ne kao HTTP kod) i resetira se u ponoć u vremenskoj zoni spremljenoj u tvom računu.
Primjeri korištenja
Svi primjeri koriste cURL s MCP JSON-RPC protokolom. Zamijeni YOUR_TOKEN svojim pristupnim tokenom.
Čitanje podataka
# Get your profile and stats
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_profile"}}'
# List recent notes (limit 5, from April 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'
# Search notes (hybrid text + semantic)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"search","arguments":{"query":"project deadline","limit":5}}}'
Pisanje podataka (Pro i Ultra)
# Process a note through full AI pipeline (extracts tasks + events)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
"params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'
# Create a task with deadline and reminder
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
"params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'
# Create a repeating event with reminders and attendees
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
"params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'
# Complete a task
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
"params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'
Uspješan odgovor izgleda ovako:
{
"jsonrpc": "2.0",
"id": 11,
"result": {
"content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
}
}
Alati za pisanje i ažuriranje vraćaju kratke odgovore, uglavnom id, title i status. Alati za brisanje vraćaju id i deleted. Za pune pojedinosti (oznake, prioritet, rok itd.) nakon pisanja pošalji naknadni poziv za čitanje poput get_tasks ili get_note.
Upravljanje tokenom
| Radnja | Kako |
|---|---|
| Prikaz tokena | iPhone Postavke > Integracije > AI agenti (MCP) > Za programere (ili na webu Postavke > Integracije > AI agenti (MCP)), dodirni Prikaži |
| Kopiranje tokena | Dodirni Kopiraj pokraj tokena |
| Regeneriranje | Dodirni Regeneriraj token i potvrdi. Stari token odmah prestaje raditi. Asistenti povezani OAuth prijavom nisu pogođeni; prekini njihovu vezu pod Povezane aplikacije |
| Promjena načina | Pro i Ultra: odaberi Samo za čitanje ili Čitanje i pisanje. Free i Basic su uvijek samo za čitanje |
| Onemogućavanje | Dodirni Onemogući i potvrdi ("Ovime će se opozvati pristup svim povezanim AI alatima."). Tvoj token se briše i sve veze prestaju. Ako ponovno omogućiš MCP, dobiješ novi token, a aplikacije povezane prijavom (OAuth) ponovno rade bez nove prijave. Da aplikaciju trajno ukloniš, dodirni Prekini vezu pod Povezane aplikacije |
Što možeš pitati svog AI agenta
Kad se poveže, svom AI alatu postavljaj ovakva pitanja:
Pregled dana:
- "Na čemu sam danas radio?"
- "Pokaži mi moje bilješke iz ovog tjedna"
- "Koji zadaci kasne?"
Upravljanje zadacima:
- "Stvori zadatak: pregledati kvartalno izvješće, visok prioritet, rok petak"
- "Označi Figma zadatak kao gotov"
- "Na kojim zadacima radim?"
Pretraživanje i analiza:
- "Pronađi sve bilješke o marketinškoj strategiji"
- "Koje događaje imam sljedeći tjedan?"
- "Sažmi moja dnevna izvješća od prošlog tjedna"
Planiranje unaprijed:
- "Stvori događaj: dnevni sastanak tima sutra u 10 sati"
- "Što je u mom kalendaru ovaj tjedan?"
- "Pokaži mi moje najčešće oznake - čemu posvećujem najviše vremena?"
Tvoj asistent može čitati tvoje bilješke, zadatke, događaje i izvješća te odgovarati na složena pitanja povezujući informacije iz više alata. Na planovima Pro i Ultra s uključenim načinom Čitanje i pisanje može ih i stvarati, ažurirati i brisati.
Dobro je znati
- Integracije i automatizacije -
process_noteradi kao snimka, pa njegova bilješka, zadaci i događaji idu u tvoje povezane integracije i webhook automatizacije. Stavke koje stvoriš, izmijeniš ili izbrišeš ostalim alatima za pisanje ponašaju se točno kao u aplikaciji: stižu u tvoje povezane integracije (događaji i izmjene bilješki stižu samo u Notion) i u tvoje automatizacije. Vraćanje zadatka pomoćurestore_entityili poništavanje njegova dovršavanja pomoćuundo_change_log_entryponovno ga otvara i u integracijama s kojima je bio sinkroniziran. - Izmjene AI asistenta - u povijesti stavke označene su kao izmjene koje je napravio asistent. Ne koriste se za učenje TellDone prepoznavanja govora i ne kopiraju se u ostale stavke bilješke. Izmjene putem asistenta dijele ograničenje aplikacije od 30 izmjena u minuti.
- Semantičko pretraživanje - bilješke stvorene pomoću
process_noteilicreate_noteobje dobivaju embeddinge, pa se u semantičkom pretraživanju pojavljuju nakon kratke odgode. - Filtri datuma - za bilješke su datumi UTC dani. Za događaje su datumi tvoji lokalni dani, a događaj koji se preklapa s rasponom uključen je. Za zadatke filtar je datum roka.
Sigurnost
- Svaki korisnik dobiva jedinstven 384-bitni pristupni token
- Tvoj token se opoziva odmah kad onemogućiš MCP ili ga regeneriraš
- Svaki zahtjev ograničen je na tvoj račun, pa tvoj agent može pristupiti samo tvojim podacima
- Veza koristi HTTPS s ograničenjem brzine (5 zahtjeva/s, naleti do 20)
- OAuth veze koriste PKCE s jednokratnim autorizacijskim kodovima i kratkotrajnim pristupnim tokenima - vezu možeš opozvati u bilo kojem trenutku iz aplikacije
Za tehnički detaljan opis - krajnje točke za otkrivanje, trajanje tokena, cijeli OAuth tijek - pogledaj našu referencu konektora otvorenog koda na github.com/exp78/telldone-mcp ili izravno upitaj https://api.telldone.app/.well-known/oauth-protected-resource.
Privatnost i tok podataka
Povezani AI alat dobiva tvoje podatke samo kad pozove TellDone, obično jer si mu nešto postavio kao pitanje. Prima samo odgovore na te pozive, unutar dozvola koje si odobrio. Za ograničavanje pristupa prijeđi na Samo za čitanje, prekini vezu aplikacije pod Povezane aplikacije ili regeneriraj ili onemogući svoj pristupni token u Postavkama. Sve pojedinosti potraži u Pravilima privatnosti ili piši na support@telldone.app ako imaš pitanja.
Rješavanje problema
| Simptom | Uzrok / rješenje |
|---|---|
| Stranica za pristanak OAuth-a kaže "Wrong email or password" | Upotrijebi e-poštu i lozinku kojima se prijavljuješ u aplikaciju ili na istoj stranici odaberi Sign in with Apple / Sign in with Google. |
| Povezano je, ali AI ne može ništa stvoriti ni urediti | Tvoj plan je Free ili Basic (samo čitanje), tvoj način je samo za čitanje ili veza nema dozvole za pisanje. Ako si se povezao prije nadogradnje, prekini vezu aplikacije pod Povezane aplikacije i poveži je ponovno. Svoj način možeš provjeriti u Postavkama. |
| Pogreška "Insufficient scope" iz alata | Veza nema tu dozvolu. Na planovima Free i Basic dozvole za pisanje nikad se ne dodjeljuju, pa stvaranje i uređivanje traži Pro ili Ultra. Ako si se povezao prije nadogradnje, prekini vezu aplikacije pod Povezane aplikacije i poveži je ponovno. |
Kopirani isječak kaže YOUR_TOKEN i klijent se ne može povezati | Kopirao si ga dok je token bio skriven. U Za programere dodirni Prikaži, zatim ponovno kopiraj isječak. |
| Alati se uopće ne pojavljuju | MCP nije omogućen na tvom računu (Postavke > Integracije > AI agenti (MCP) > Omogući). |
| "Daily limit reached" | Ovu poruku koriste dva ograničenja. "Daily limit reached: the Free plan includes 100 TellDone requests a day" je ograničenje zahtjeva na planu Free. "Daily limit reached (N/M today)" znači da si danas pomoću AI asistenata stvorio onoliko stavki koliko tvoj plan dopušta: process_note, create_note, create_task i create_event svaki se računa, i na planovima Pro i Ultra. Oba se resetiraju u ponoć u vremenskoj zoni spremljenoj u tvom računu. |
| Moj klijent dopušta samo odabir s popisa konektora, a TellDone nije na njemu | TellDone još nije ni u jednom direktoriju konektora klijenata - dodaj ga kao prilagođeni konektor s MCP URL-om ili upotrijebi metodu bearer tokena. |
Vidi još
- Webhook automatizacije - automatski šalji podatke vanjskim uslugama
- Todoist - namjenska dvosmjerna sinkronizacija zadataka
- Notion - namjenska integracija s Notionom