MCP Access (AI agents)

Τι άλλαξε πρόσφατα

Το MCP είναι τώρα πλήρως διαθέσιμο σε iPhone (επιπλέον της web εφαρμογής). Η οθόνη iPhone αντικατοπτρίζει τη web και περιλαμβάνει τα ίδια setup snippets για όλους τους υποστηριζόμενους AI clients.

Πλάνο Pro και πάνω

Το MCP Access απαιτεί πλάνο Pro ή Ultra. Και τα δύο πλάνα παίρνουν πλήρη πρόσβαση read + write (20 εργαλεία). Το Ultra έχει υψηλότερα όρια και μπορεί επίσης να μεταβεί σε read-only mode.

Το MCP (Model Context Protocol) σου επιτρέπει να συνδέσεις AI coding assistants και εργαλεία αυτοματισμού απευθείας στα δεδομένα TellDone σου. Μόλις συνδεθούν, ο AI agent σου μπορεί να διαβάσει σημειώσεις, εργασίες, εκδηλώσεις και αναφορές - και να δημιουργήσει, να ενημερώσει και να διαγράψει στοιχεία. Υπάρχουν 20 εργαλεία συνολικά: 9 για ανάγνωση δεδομένων και 11 για εγγραφή.

Διαθέσιμο και στην εφαρμογή iPhone (Ρυθμίσεις -> Ενσωματώσεις -> AI Agents) και στη web εφαρμογή (Ρυθμίσεις -> AI Agents).

Απαιτήσεις πλάνου

Πλάνο	MCP
Free	Κλειδωμένο
Basic	Κλειδωμένο
Pro	Read + Write (20 εργαλεία)
Ultra	Read + Write (20 εργαλεία, υψηλότερα όρια) - μπορεί επίσης να μεταβεί σε Read-only mode

Η οθόνη εντός εφαρμογής

Η οθόνη AI Agents έχει τρεις καταστάσεις ανάλογα με το πλάνο σου και αν το MCP είναι ενεργοποιημένο.

Κλειδωμένο (Free και Basic)

Αν είσαι σε πλάνο Free ή Basic, η οθόνη εξηγεί τι κάνει το MCP και δείχνει ένα κουμπί Upgrade. Πατώντας το ανοίγει το paywall όπου μπορείς να μεταβείς σε Pro ή Ultra.

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)

Αν είσαι σε Pro ή Ultra αλλά δεν έχεις ενεργοποιήσει το MCP ακόμη, η οθόνη δείχνει μια σύντομη περίληψη του τι μπορεί να κάνει το πλάνο σου (αριθμός εργαλείων, mode πρόσβασης, όρια) και ένα κουμπί Enable. Πάτησέ το για να παράγει το token σύνδεσής σου και να ξεκινήσει η ενσωμάτωση.

Ενεργοποιημένο

Μόλις ενεργοποιηθεί, η οθόνη δείχνει όλα όσα χρειάζεσαι για να συνδέσεις έναν AI client:

Διακόπτης mode - σε Ultra μπορείς να εναλλάσσεις ανάμεσα σε Read-only και Read + Write. Σε Pro το mode είναι σταθερό σε Read + Write.
Γραμμή Access Token με διακόπτη ματιού για αποκάλυψη ή απόκρυψη του token και κουμπί αντιγραφής.
Setup picker με καρτέλες για Claude Code, Cursor, Windsurf και Other. Το αντίστοιχο code snippet εμφανίζεται κάτω από τις καρτέλες - απλώς αντιγράφεις και επικολλάς στον AI client σου.
Κουμπί Regenerate - εναλλάσσει το token αμέσως και αποσυνδέει τυχόν ενεργές συνεδρίες που χρησιμοποιούν το παλιό.
Κουμπί Disable - απενεργοποιεί το MCP και διαγράφει το token. Μπορείς να το ξαναενεργοποιήσεις αργότερα, αλλά θα εκδοθεί νέο token.

συμβουλή

Κράτα το token σύνδεσής σου ιδιωτικό. Όποιος έχει το token μπορεί να αποκτήσει πρόσβαση στα δεδομένα TellDone σου. Χρησιμοποίησε Regenerate αν υποψιάζεσαι ποτέ ότι το token διέρρευσε.

Πώς να ενεργοποιήσεις

Μπορείς να διαμορφώσεις το MCP από οποιαδήποτε πλατφόρμα:

iPhone: Ρυθμίσεις -> Ενσωματώσεις -> AI Agents (MCP)
Web: app.telldone.app -> Ρυθμίσεις -> AI Agents

Βήματα:

Πάτα Enable.
Διάλεξε mode πρόσβασης (μόνο Ultra - το Pro είναι πάντα Read + Write).
Αποκάλυψε και αντίγραψε το token σου χρησιμοποιώντας τα εικονίδια ματιού και αντιγραφής.
Διάλεξε το εργαλείο σου στην ενότητα Setup (Claude Code, Cursor, Windsurf ή Other).
Επικόλλησε το snippet στη διαμόρφωση του AI client σου.

Σύνδεση του AI εργαλείου σου

Οι τέσσερις καρτέλες στον εντός εφαρμογής Setup picker (Claude Code, Cursor, Windsurf, Other) ταιριάζουν με τις παρακάτω ενότητες. Αντικατέστησε το YOUR_TOKEN με το token από τις ρυθμίσεις σου σε όλα τα παραδείγματα.

Claude Code

Τρέξε αυτή την εντολή στο τερματικό σου:

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Πρόσθεσε στο .cursor/mcp.json:

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

Windsurf

Πρόσθεσε στο .codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Other

Χρησιμοποίησε αυτά τα snippets για clients που ο εντός εφαρμογής picker ομαδοποιεί κάτω από Other.

Codex

Πρόσθεσε στο 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

Άλλοι MCP clients

Οποιοδήποτε εργαλείο υποστηρίζει MCP πάνω από HTTP μπορεί να συνδεθεί. Χρησιμοποίησε το endpoint https://api.telldone.app/mcp/user/mcp με μια κεφαλίδα authorization Bearer YOUR_TOKEN.

Εναλλακτική κεφαλίδα auth

Αν ο client ή proxy σου κρατάει την κεφαλίδα Authorization (για παράδειγμα, μερικά Smithery-style gateways), στείλε το token στο X-MCP-Token: YOUR_TOKEN αντί γι' αυτό. Και οι δύο κεφαλίδες δουλεύουν· αν είναι παρούσες και οι δύο, νικάει το Authorization.

Δοκιμή της σύνδεσής σου

Μπορείς να επαληθεύσεις ότι το token σου δουλεύει με μια απλή εντολή cURL:

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}'

Μια επιτυχημένη απάντηση παραθέτει όλα τα διαθέσιμα εργαλεία.

Τι μπορείς να κάνεις

Read tools (9) - Pro και Ultra

Εργαλείο	Τι κάνει
get_notes	Παράθεση σημειώσεων με φίλτρα (ετικέτες, εύρος ημερομηνιών, αναζήτηση κειμένου)
get_note	Δες μια μεμονωμένη σημείωση με τις θυγατρικές της εργασίες, εκδηλώσεις και πλήρη μεταγραφή
get_notes_full	Πάρε πολλαπλές σημειώσεις με ενσωματωμένες εργασίες και εκδηλώσεις σε μία κλήση
get_tasks	Παράθεση εργασιών φιλτραρισμένων ανά κατάσταση (to-do, done, all), ετικέτες ή ημερομηνίες
get_events	Παράθεση εκδηλώσεων ημερολογίου, φιλτράρισμα ανά εύρος ημερομηνιών
get_reports	Διάβασε τις ημερήσιες, εβδομαδιαίες, μηνιαίες και ετήσιες αναφορές σου (πλήρες markdown)
get_tags	Δες όλες τις ετικέτες σου ταξινομημένες κατά χρήση
get_profile	Δες τις πληροφορίες λογαριασμού και τα στατιστικά χρήσης σου
search	Αναζήτησε σε σημειώσεις, εργασίες και εκδηλώσεις (text + semantic search για σημειώσεις)

συμβουλή

Το εργαλείο search υποστηρίζει semantic search για σημειώσεις - βρίσκει αποτελέσματα με βάση το νόημα, όχι μόνο λέξεις-κλειδιά. Για παράδειγμα, αναζητώντας "meetings about budget" θα βρει σημειώσεις για οικονομικές συζητήσεις ακόμη και αν δεν περιέχουν τη λέξη "budget".

Write tools (11) - Pro και Ultra

Εργαλείο	Τι κάνει
process_note	Πλήρης διαδικασία επεξεργασίας AI - στείλε κείμενο ή ήχο, πάρε πίσω μια σημείωση με εργασίες, εκδηλώσεις και ετικέτες
create_note	Πρόσθεσε μια απλή σημείωση κειμένου (χωρίς ανάλυση AI)
create_task	Πρόσθεσε μια εργασία με προτεραιότητα, προθεσμία, υπενθύμιση και ετικέτες
create_event	Πρόσθεσε μια εκδήλωση ημερολογίου με ημερομηνία, ώρα, τοποθεσία, υπενθυμίσεις, συμμετέχοντες και επανάληψη
update_note	Άλλαξε τίτλο σημείωσης, περίληψη, τύπο, ετικέτες, προτεραιότητα ή κατάσταση
update_task	Άλλαξε τίτλο εργασίας, περιγραφή, προτεραιότητα, προθεσμία, υπενθύμιση, ετικέτες ή κατάσταση
complete_task	Σημείωσε μια εργασία ως ολοκληρωμένη
update_event	Άλλαξε λεπτομέρειες εκδήλωσης, ώρα, τοποθεσία, υπενθυμίσεις, συμμετέχοντες, επανάληψη, ετικέτες ή κατάσταση
delete_note	Διάγραψε μια σημείωση και όλες τις συνδεδεμένες εργασίες και εκδηλώσεις της
delete_task	Διάγραψε μια εργασία
delete_event	Διάγραψε μια εκδήλωση

Όλες οι λειτουργίες εγγραφής και διαγραφής εμφανίζονται αμέσως στις συνδεδεμένες συσκευές σου (τηλέφωνο, web app) μέσω συγχρονισμού πραγματικού χρόνου.

Αναφορά εργαλείων

get_notes

Παράθεση σημειώσεων με προαιρετικό φιλτράρισμα. Τα φίλτρα ημερομηνίας χρησιμοποιούν recorded_at (πότε έκανες εγγραφή της ηχητικής σημείωσης), όχι created_at.

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	20	Αριθμός σημειώσεων προς επιστροφή (max 50)
`offset`	int	0	Παράλειψε τόσες σημειώσεις (για pagination, max 10000)
`tags`	string	-	Φιλτράρισμα ανά ετικέτες, διαχωρισμένες με κόμμα (ταιριάζει σε οποιαδήποτε)
`search`	string	-	Αναζήτηση κειμένου σε τίτλο και περίληψη
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (συμπεριλαμβανομένης)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD (αποκλειστική)

Επιστρέφει: λίστα σημειώσεων με id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Πάρε μια μεμονωμένη σημείωση με την πλήρη μεταγραφή της και όλες τις συνδεδεμένες εργασίες και εκδηλώσεις.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Το UUID της σημείωσης

Επιστρέφει: σημείωση με title, summary, transcript, type, tags, priority, status, metadata, created_at, συν tasks[] και events[] arrays.

get_notes_full

Πάρε πολλαπλές σημειώσεις με τις εργασίες και εκδηλώσεις τους σε μία κλήση. Ίδια φίλτρα με get_notes, αλλά κάθε σημείωση περιλαμβάνει ενσωματωμένα tasks[] και events[].

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	10	Αριθμός σημειώσεων (max 20)
`offset`	int	0	Παράλειψε τόσες σημειώσεις
`tags`	string	-	Φιλτράρισμα ανά ετικέτες
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD

get_tasks

Παράθεση εργασιών με φιλτράρισμα.

Παράμετρος	Τύπος	Default	Περιγραφή
`status`	string	"todo"	Φίλτρο: `todo`, `done` ή `all`
`limit`	int	30	Αριθμός εργασιών (max 100)
`offset`	int	0	Παράλειψε τόσες εργασίες
`tags`	string	-	Φιλτράρισμα ανά ετικέτες, διαχωρισμένες με κόμμα
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (φιλτράρισμα κατά προθεσμία· εργασίες χωρίς προθεσμία εξαιρούνται)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD (φιλτράρισμα κατά προθεσμία· εργασίες χωρίς προθεσμία εξαιρούνται)

Επιστρέφει: λίστα εργασιών με id, title, description, status, priority, tags, deadline, reminder_at, completed_at, completed_by, source, created_at.

get_events

Παράθεση εκδηλώσεων ημερολογίου με φιλτράρισμα εύρους ημερομηνιών.

Παράμετρος	Τύπος	Default	Περιγραφή
`limit`	int	30	Αριθμός εκδηλώσεων (max 100)
`offset`	int	0	Παράλειψε τόσες εκδηλώσεις
`date_from`	string	-	Ημερομηνία έναρξης, YYYY-MM-DD (φιλτράρει ανά ώρα έναρξης εκδήλωσης)
`date_to`	string	-	Ημερομηνία λήξης, YYYY-MM-DD

Επιστρέφει: λίστα εκδηλώσεων με id, title, description, status, start_at, end_at, location, is_all_day, tags, created_at.

σημείωση

Το get_events δεν επιστρέφει attendees, reminder_minutes ή recurrence_rule. Αυτά είναι εγγράψιμα μέσω create_event/update_event αλλά δεν περιλαμβάνονται στην έξοδο λίστας. Αν τα χρειάζεσαι, πάρε τη γονική σημείωση με get_note.

get_reports

Πάρε τις παραγμένες από AI αναφορές σου με πλήρες περιεχόμενο markdown.

Παράμετρος	Τύπος	Default	Περιγραφή
`report_type`	string	"daily"	Τύπος: `daily`, `weekly`, `monthly` ή `yearly`
`limit`	int	5	Αριθμός αναφορών (max 10)

Επιστρέφει: λίστα αναφορών με id, type, period_start, period_end, content_md, created_at.

σημείωση

Οι μηνιαίες αναφορές μπορεί να είναι 3.000-5.000 λέξεις. Χρησιμοποίησε limit=1 αν το AI εργαλείο σου έχει στενό context window.

get_tags

Πάρε όλες τις ετικέτες σου, ταξινομημένες με τις pinned πρώτες, μετά κατά αριθμό χρήσης.

Χωρίς παραμέτρους. Επιστρέφει έως 100 ετικέτες, καθεμία με tag, usage_count, is_pinned, is_manual.

get_profile

Πάρε τις πληροφορίες λογαριασμού και τα στατιστικά χρήσης σου.

Χωρίς παραμέτρους. Επιστρέφει email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at και stats (αριθμοί σημειώσεων/εργασιών/εκδηλώσεων).

search

Αναζήτηση σε σημειώσεις, εργασίες και εκδηλώσεις ταυτόχρονα. Για σημειώσεις, υποστηρίζει και αναζήτηση κειμένου και semantic search (βρίσκει αποτελέσματα με βάση το νόημα χρησιμοποιώντας AI embeddings).

Παράμετρος	Τύπος	Default	Περιγραφή
`query`	string	required	Κείμενο αναζήτησης (max 500 χαρακτήρες)
`limit`	int	20	Max αποτελέσματα ανά τύπο (max 20)
`semantic`	bool	true	Ενεργοποίηση semantic search για σημειώσεις

Επιστρέφει αποτελέσματα ομαδοποιημένα κατά τύπο: notes[], tasks[], events[]. Κάθε αποτέλεσμα έχει id, type, title, detail, created_at.

Όρισε semantic=false για πιο γρήγορη αναζήτηση μόνο κειμένου.

process_note (Pro και Ultra)

Πλήρης διαδικασία επεξεργασίας AI - δουλεύει το ίδιο όπως η εγγραφή στην εφαρμογή. Στείλε κείμενο ή ήχο και το TellDone θα μεταγράψει, θα αναλύσει με AI και θα δημιουργήσει μια δομημένη σημείωση με εξαγμένες εργασίες, εκδηλώσεις, ετικέτες και embeddings.

Αυτό το εργαλείο είναι ασύγχρονο: επιστρέφει αμέσως με ένα audio_id και επεξεργάζεται στο παρασκήνιο. Τα αποτελέσματα φτάνουν μέσω συγχρονισμού πραγματικού χρόνου στις συνδεδεμένες συσκευές σου, ή μπορείς να ρωτάς με get_notes().

Παράμετρος	Τύπος	Περιγραφή
`text`	string	Κείμενο προς ανάλυση (παραλείπει τη μεταγραφή αν δεν παρέχεται ήχος)
`audio_base64`	string	Base64-encoded αρχείο ήχου (έως 50MB, ενεργοποιεί μεταγραφή)
`audio_format`	string	`m4a`, `ogg`, `wav`, `mp3`, `aac` ή `webm` (default: m4a)
`parent_task_id`	string	UUID μιας εργασίας στην οποία αυτό είναι follow-up
`parent_note_id`	string	UUID μιας σημείωσης στην οποία αυτό είναι follow-up
`parent_event_id`	string	UUID μιας εκδήλωσης στην οποία αυτό είναι follow-up

Πρέπει να παρέχεις είτε text είτε audio_base64 (ή και τα δύο - ο ήχος έχει προτεραιότητα για μεταγραφή).

Επιστρέφει: {"audio_id": "...", "status": "processing", "mode": "text-only"} ή "mode": "audio+stt" αν παρασχέθηκε ήχος.

σημείωση

Το process_note υπόκειται στα όρια του πλάνου σου (uploads ανά μέρα, σημειώσεις ανά μήνα, μέγιστο μήκος κειμένου). Χρησιμοποίησε get_profile για να ελέγξεις την τρέχουσα χρήση σου.

create_note (Pro και Ultra)

Δημιούργησε μια απλή σημείωση κειμένου αμέσως. Δεν ενεργοποιεί ανάλυση AI - δεν εξάγονται εργασίες ή εκδηλώσεις. Για πλήρη ανάλυση AI με εξαγωγή εργασιών/εκδηλώσεων, χρησιμοποίησε process_note αντί γι' αυτό.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`summary`	string	1000 χαρακτήρες	Προαιρετικό. Σύντομο teaser (1-3 προτάσεις). Περιλαμβάνεται στα prompts αναφορών, οπότε κράτα το σύντομο
`transcript`	string	βάσει πλάνου	Προαιρετικό. Long-form σώμα που εμφανίζεται στη λεπτομέρεια σημείωσης. Δεν περιλαμβάνεται σε αναφορές. Όρια: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000 χαρακτήρες
`type`	string	-	Προαιρετικό. `task`, `idea`, `info` (default), `status`, `meeting`, `event` ή `reflection`
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά

create_task (Pro και Ultra)

Δημιούργησε μια νέα εργασία.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`description`	string	2000 χαρακτήρες	Προαιρετικό
`priority`	string	-	`low`, `medium` (default) ή `high`
`deadline`	string	-	YYYY-MM-DD, προαιρετικό
`reminder_at`	string	-	ISO 8601 datetime (π.χ. `2026-04-15T09:00:00Z`), προαιρετικό
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά
`note_id`	string	-	UUID για να συνδεθεί η εργασία με μια γονική σημείωση, προαιρετικό

create_event (Pro και Ultra)

Δημιούργησε μια εκδήλωση ημερολογίου.

Παράμετρος	Τύπος	Όριο	Περιγραφή
`title`	string	200 χαρακτήρες	Required
`start_at`	string	-	ISO 8601 datetime, required
`end_at`	string	-	ISO 8601 datetime (default: start + 1 ώρα)
`description`	string	2000 χαρακτήρες	Προαιρετικό
`location`	string	200 χαρακτήρες	Προαιρετικό
`is_all_day`	bool	-	Default: false
`tags`	string	20 tags	Διαχωρισμένα με κόμμα, προαιρετικά
`reminder_minutes`	string	-	Διαχωρισμένα με κόμμα λεπτά πριν την εκδήλωση (π.χ. `15,60`), προαιρετικά
`attendees`	string	-	Διαχωρισμένα με κόμμα ονόματα ή emails, προαιρετικά
`recurrence_rule`	string	-	RRULE string (π.χ. `FREQ=WEEKLY;BYDAY=MO,WE,FR`), προαιρετικό
`note_id`	string	-	UUID για να συνδεθεί η εκδήλωση με γονική σημείωση, προαιρετικό

update_note (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα σημείωση. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Required, το UUID της σημείωσης
`title`	string	Νέος τίτλος (max 200 χαρακτήρες)
`summary`	string	Νέα περίληψη (max 1000 χαρακτήρες, πέρασε ένα κενό `" "` για καθαρισμό)
`transcript`	string	Νέα μεταγραφή (όριο βάσει πλάνου, πέρασε ένα κενό `" "` για καθαρισμό)
`type`	string	`task`, `idea`, `info`, `status`, `meeting`, `event` ή `reflection`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`priority`	string	`low`, `medium` ή `high`
`status`	string	`active` ή `archived`

προσοχή

Για σημειώσεις που δημιουργήθηκαν από τη διαδικασία επεξεργασίας φωνής, το transcript είναι η πρωτότυπη έξοδος speech-to-text. Η αντικατάστασή του αντικαθιστά την κανονική πηγή - σκέψου να κάνεις append σε αυτό αν θες να διατηρήσεις το πρωτότυπο.

update_task (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα εργασία. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας
`title`	string	Νέος τίτλος
`description`	string	Νέα περιγραφή (πέρασε ένα κενό `" "` για καθαρισμό)
`priority`	string	`low`, `medium` ή `high`
`deadline`	string	YYYY-MM-DD (πέρασε ένα κενό για καθαρισμό)
`status`	string	`todo` ή `done`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`reminder_at`	string	ISO 8601 datetime (πέρασε ένα κενό για καθαρισμό)

Ο ορισμός status σε done καταγράφει επίσης πότε και πώς ολοκληρώθηκε η εργασία.

complete_task (Pro και Ultra)

Συντόμευση για να σημειώσεις μια εργασία ως ολοκληρωμένη.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας

Επιστρέφει σφάλμα αν η εργασία δεν υπάρχει ή είναι ήδη ολοκληρωμένη.

update_event (Pro και Ultra)

Ενημέρωσε ένα ή περισσότερα πεδία σε μια υπάρχουσα εκδήλωση. Αλλάζουν μόνο τα πεδία που παρέχεις.

Παράμετρος	Τύπος	Περιγραφή
`event_id`	string	Required, το UUID της εκδήλωσης
`title`	string	Νέος τίτλος
`description`	string	Νέα περιγραφή (πέρασε ένα κενό για καθαρισμό)
`start_at`	string	Νέα ώρα έναρξης (ISO 8601)
`end_at`	string	Νέα ώρα λήξης (ISO 8601)
`location`	string	Νέα τοποθεσία (πέρασε ένα κενό για καθαρισμό)
`status`	string	`confirmed`, `tentative` ή `cancelled`
`tags`	string	Διαχωρισμένες με κόμμα ετικέτες (αντικαθιστά όλες τις υπάρχουσες, max 20)
`is_all_day`	string	`"true"` ή `"false"`
`reminder_minutes`	string	Διαχωρισμένα με κόμμα λεπτά πριν την εκδήλωση (π.χ. `15,60`)
`attendees`	string	Διαχωρισμένα με κόμμα ονόματα ή emails
`recurrence_rule`	string	RRULE string (πέρασε ένα κενό για καθαρισμό)

delete_note (Pro και Ultra)

Διάγραψε μια σημείωση. Αυτό διαγράφει επίσης όλες τις εργασίες και εκδηλώσεις που δημιουργήθηκαν από αυτή τη σημείωση.

Παράμετρος	Τύπος	Περιγραφή
`note_id`	string	Required, το UUID της σημείωσης

delete_task (Pro και Ultra)

Διάγραψε μια εργασία.

Παράμετρος	Τύπος	Περιγραφή
`task_id`	string	Required, το UUID της εργασίας

delete_event (Pro και Ultra)

Διάγραψε μια εκδήλωση.

Παράμετρος	Τύπος	Περιγραφή
`event_id`	string	Required, το UUID της εκδήλωσης

Όρια εισόδου

Πεδίο	Μέγιστο μήκος	Χρησιμοποιείται σε
title	200 χαρακτήρες	create/update note, task, event
description	2.000 χαρακτήρες	create/update task, event
summary	1.000 χαρακτήρες (hard)	create/update note. Περιλαμβάνεται σε prompts αναφορών, κρατείται σύντομο για έλεγχο κόστους token
transcript	βάσει πλάνου: Free 2.000 / Basic 8.000 / Pro 20.000 / Ultra 50.000	create/update note. Long-form σώμα, όχι σε αναφορές
location	200 χαρακτήρες	create/update event
tags	20 tags	create/update note, task, event
search query	500 χαρακτήρες	search
audio_base64 (decoded)	50 MB	process_note

Αν υπερβείς ένα όριο, το εργαλείο επιστρέφει μήνυμα σφάλματος όπως "title too long (max 200 chars, got 250)".

Χειρισμός σφαλμάτων

Όλα τα εργαλεία επιστρέφουν JSON. Τα σφάλματα χρησιμοποιούν αυτή τη μορφή:

{"error": "description of what went wrong"}

Συνηθισμένα σφάλματα:

Σφάλμα	Πότε
`"MCP access is read-only..."`	Κλήθηκε εργαλείο εγγραφής σε read-only mode
`"Invalid note_id format"`	Πέρασε string που δεν είναι UUID ως ID
`"Note not found"`	Το ID δεν υπάρχει ή ανήκει σε άλλον χρήστη
`"Task not found or already completed"`	`complete_task` σε ανύπαρκτη ή ήδη ολοκληρωμένη εργασία
`"title too long (max 200 chars, got N)"`	Όριο εισόδου ξεπεράστηκε
`"Too many tags (max 20)"`	Παρασχέθηκαν περισσότερα από 20 tags

Σφάλματα HTTP-level:

Code	Σημασία
401	Άκυρο ή λείπει το Bearer token
403	MCP απενεργοποιημένο ή το πλάνο δεν επιτρέπει MCP
429	Όριο ρυθμού ξεπεράστηκε (5 req/s)

Παραδείγματα χρήσης

Όλα τα παραδείγματα χρησιμοποιούν cURL με το πρωτόκολλο MCP JSON-RPC. Αντικατέστησε YOUR_TOKEN με το token σύνδεσής σου.

Ανάγνωση δεδομένων

# 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}}}'

Εγγραφή δεδομένων (Pro και 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 recurring 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>"}}}'

Μια επιτυχημένη απάντηση μοιάζει έτσι:

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}

σημείωση

Τα εργαλεία εγγραφής και ενημέρωσης επιστρέφουν ελάχιστες απαντήσεις με μόνο id, title και status. Για να πάρεις πλήρεις λεπτομέρειες (tags, προτεραιότητα, προθεσμία κλπ.) μετά από εγγραφή, κάνε μια follow-up κλήση ανάγνωσης όπως get_tasks ή get_note.

Διαχείριση token

Ενέργεια	Πώς
Δες το token	iPhone Ρυθμίσεις -> Ενσωματώσεις -> AI Agents (ή web Ρυθμίσεις -> AI Agents), πάτα το εικονίδιο ματιού
Αντίγραψε το token	Πάτα το εικονίδιο αντιγραφής δίπλα στο token
Regenerate	Πάτα Regenerate και επιβεβαίωσε. Το παλιό token σταματά να δουλεύει αμέσως και τυχόν ενεργές συνεδρίες αποσυνδέονται
Άλλαξε mode	Μόνο Ultra - εναλλαγή ανάμεσα σε Read-only και Read + Write. Σε Pro το mode είναι σταθερό σε Read + Write
Disable	Πάτα Disable και επιβεβαίωσε. Το token διαγράφεται και όλες οι συνδέσεις σταματάνε. Μπορείς να το ξαναενεργοποιήσεις αργότερα (θα εκδοθεί νέο token)

Τι μπορείς να ζητήσεις από τον AI agent σου

Μόλις συνδεθεί, ζήτα από το AI εργαλείο σου πράγματα όπως:

Ανασκόπηση της μέρας σου:

"Σε τι δούλεψα σήμερα;"
"Δείξε μου τις σημειώσεις μου από αυτή την εβδομάδα"
"Ποιες εργασίες είναι καθυστερημένες;"

Διαχείριση εργασιών:

"Δημιούργησε μια εργασία: ανασκόπηση τριμηνιαίας αναφοράς, υψηλή προτεραιότητα, προθεσμία Παρασκευή"
"Σημείωσε την εργασία Figma ως ολοκληρωμένη"
"Σε ποιες εργασίες δουλεύω;"

Αναζήτηση και ανάλυση:

"Βρες όλες τις σημειώσεις για τη στρατηγική marketing"
"Ποιες εκδηλώσεις έχω την επόμενη εβδομάδα;"
"Συνόψισε τις ημερήσιες αναφορές μου από την περασμένη εβδομάδα"

Σχεδίασε μπροστά:

"Δημιούργησε εκδήλωση: team standup αύριο στις 10πμ"
"Τι έχω στο ημερολόγιό μου αυτή την εβδομάδα;"
"Δείξε μου τα top tags μου - σε τι ξοδεύω τον περισσότερο χρόνο;"

Ο AI agent έχει πλήρη πρόσβαση στις σημειώσεις, εργασίες, εκδηλώσεις και αναφορές σου. Μπορεί να διαβάσει, να δημιουργήσει, να ενημερώσει και να διαγράψει δεδομένα και να απαντήσει σε σύνθετες ερωτήσεις συνδυάζοντας πληροφορίες από πολλά εργαλεία.

Σημαντικές σημειώσεις

Δύο τρόποι δημιουργίας σημειώσεων - το create_note δημιουργεί μια απλή σημείωση κειμένου αμέσως (χωρίς ανάλυση AI). Το process_note τρέχει την πλήρη διαδικασία επεξεργασίας AI (το ίδιο με την εγγραφή στην εφαρμογή) - αναλύει το κείμενο, εξάγει εργασίες και εκδηλώσεις, παράγει tags και embeddings. Χρησιμοποίησε process_note όταν θέλεις το TellDone να σκεφτεί για σένα.
Καμία ενσωμάτωση συγχρονισμού - στοιχεία που δημιουργούνται ή ενημερώνονται μέσω MCP δεν ενεργοποιούν webhook automations ή συγχρονισμούς ενσωμάτωσης (Todoist, Notion). Θα εμφανιστούν στις εφαρμογές σου στον επόμενο συγχρονισμό.
Το semantic search εξαρτάται από το εργαλείο - σημειώσεις που δημιουργούνται με process_note παίρνουν embeddings και εμφανίζονται σε semantic search. Σημειώσεις που δημιουργούνται με create_note δεν παίρνουν embeddings, οπότε εμφανίζονται μόνο σε αναζήτηση κειμένου.
Οι απαντήσεις εγγραφής είναι ελάχιστες - τα εργαλεία create και update επιστρέφουν μόνο id, title και status. Για να πάρεις όλα τα πεδία μετά από εγγραφή, κάνε μια follow-up κλήση ανάγνωσης.
Τα φίλτρα ημερομηνίας χρησιμοποιούν UTC - οι παράμετροι date_from/date_to συγκρίνονται ως UTC timestamps. Για χρήστες σε non-UTC ζώνες ώρας, οι οριακές ημερομηνίες μπορεί να συμπεριλαμβάνουν ή να αποκλείουν στοιχεία από γειτονικές ημέρες.
Όριο ρυθμού - 5 αιτήματα ανά δευτερόλεπτο. Για bulk λειτουργίες, ρύθμισε τον ρυθμό των αιτημάτων σου.

Ασφάλεια

Κάθε χρήστης παίρνει ένα μοναδικό token σύνδεσης 384-bit
Το token σου ανακαλείται αμέσως όταν απενεργοποιείς το MCP ή το αναγεννάς
Όλα τα δεδομένα είναι αυστηρά απομονωμένα στον λογαριασμό σου - ο agent σου μπορεί να αποκτήσει πρόσβαση μόνο στα δικά σου δεδομένα
Κάθε αίτημα είναι περιορισμένο στον χρήστη σου - δεν υπάρχει τρόπος ένας agent να αποκτήσει πρόσβαση σε δεδομένα άλλου χρήστη
Η σύνδεση χρησιμοποιεί HTTPS με όριο ρυθμού (5 req/s)

Δες επίσης

Webhook automations - στείλε δεδομένα σε εξωτερικές υπηρεσίες αυτόματα
Todoist - ειδικός αμφίδρομος συγχρονισμός εργασιών
Notion - ειδική ενσωμάτωση Notion

Απαιτήσεις πλάνου​

Η οθόνη εντός εφαρμογής​

Κλειδωμένο (Free και Basic)​

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)​

Ενεργοποιημένο​

Πώς να ενεργοποιήσεις​

Σύνδεση του AI εργαλείου σου​

Claude Code​

Cursor​

Windsurf​

Other​

Codex​

OpenClaw​

Άλλοι MCP clients​

Δοκιμή της σύνδεσής σου​

Τι μπορείς να κάνεις​

Read tools (9) - Pro και Ultra​

Write tools (11) - Pro και Ultra​

Αναφορά εργαλείων​

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

process_note (Pro και Ultra)​

create_note (Pro και Ultra)​

create_task (Pro και Ultra)​

create_event (Pro και Ultra)​

update_note (Pro και Ultra)​

update_task (Pro και Ultra)​

complete_task (Pro και Ultra)​

update_event (Pro και Ultra)​

delete_note (Pro και Ultra)​

delete_task (Pro και Ultra)​

delete_event (Pro και Ultra)​

Όρια εισόδου​

Χειρισμός σφαλμάτων​

Παραδείγματα χρήσης​

Ανάγνωση δεδομένων​

Εγγραφή δεδομένων (Pro και Ultra)​

Διαχείριση token​

Τι μπορείς να ζητήσεις από τον AI agent σου​

Σημαντικές σημειώσεις​

Ασφάλεια​

Δες επίσης​

Απαιτήσεις πλάνου

Η οθόνη εντός εφαρμογής

Κλειδωμένο (Free και Basic)

Απενεργοποιημένο (Pro και Ultra, λειτουργία off)

Ενεργοποιημένο

Πώς να ενεργοποιήσεις

Σύνδεση του AI εργαλείου σου

Claude Code

Cursor

Windsurf

Other

Codex

OpenClaw

Άλλοι MCP clients

Δοκιμή της σύνδεσής σου

Τι μπορείς να κάνεις

Read tools (9) - Pro και Ultra

Write tools (11) - Pro και Ultra

Αναφορά εργαλείων

get_notes

get_note

get_notes_full

get_tasks

get_events

get_reports

get_tags

get_profile

search

process_note (Pro και Ultra)

create_note (Pro και Ultra)

create_task (Pro και Ultra)

create_event (Pro και Ultra)

update_note (Pro και Ultra)

update_task (Pro και Ultra)

complete_task (Pro και Ultra)

update_event (Pro και Ultra)

delete_note (Pro και Ultra)

delete_task (Pro και Ultra)

delete_event (Pro και Ultra)

Όρια εισόδου

Χειρισμός σφαλμάτων

Παραδείγματα χρήσης

Ανάγνωση δεδομένων

Εγγραφή δεδομένων (Pro και Ultra)

Διαχείριση token

Τι μπορείς να ζητήσεις από τον AI agent σου

Σημαντικές σημειώσεις

Ασφάλεια

Δες επίσης