AI-агенты (MCP)
MCP работает на всех планах. Free и Basic получают доступ только на чтение ко всем 10 инструментам чтения (на Free не больше 100 запросов в день). Pro и Ultra получают полный доступ на чтение и запись (27 инструментов) и при желании могут переключиться в режим только чтения.
MCP (Model Context Protocol) позволяет подключать AI-ассистентов, таких как ChatGPT и Claude, ассистентов для программирования и инструменты автоматизации напрямую к твоим данным TellDone. После подключения ассистент может читать твои заметки, задачи, события, отчёты, теги и историю изменений. На Pro и выше он также может создавать, обновлять, удалять и восстанавливать элементы. Всего 27 инструментов: 10 для чтения (на всех планах) и 17 для записи (Pro и выше).
На iPhone экран настройки MCP открывается через Настройки > Интеграции > AI-агенты (MCP), токен доступа на нём по умолчанию скрыт:
А так это выглядит в вебе:
Два способа подключения
Есть два способа подключить AI-клиент:
- Вход через TellDone (OAuth) (рекомендуется) - ты входишь в свой аккаунт TellDone и подтверждаешь то, что просит приложение. Так подключаются ChatGPT и Claude, копировать токен не нужно.
- Bearer-токен - скопируй токен доступа из настроек и вставь его в конфигурацию клиента. Проще всего для скриптов, инструментов командной строки и клиентов без встроенного входа OAuth.
| Клиент | Что выбрать |
|---|---|
| ChatGPT (chatgpt.com или приложение ChatGPT для компьютера, но не мобильное приложение) | OAuth - добавь свой MCP-сервер с MCP URL, затем войди |
| Claude (сайт, Desktop, приложение для iPhone) / Cowork | OAuth - добавь свой коннектор с MCP URL, затем войди |
| Claude Code (CLI) | Пока Bearer-токен - добавь заголовок Authorization со своим токеном |
| Скрипты или твой собственный код | Bearer-токен - проще всего автоматизировать |
| Клиент, где можно выбирать только из каталога готовых коннекторов | Добавь TellDone как свой коннектор с MCP URL или используй bearer-токен. TellDone пока нет ни в одном каталоге коннекторов |
Требования к плану
| План | MCP |
|---|---|
| Free | Только чтение (10 инструментов чтения), 100 запросов в день |
| Basic | Только чтение (10 инструментов ч тения), без дневного лимита |
| Pro | Чтение и запись (27 инструментов) - можно переключиться в режим только чтения |
| Ultra | Чтение и запись (27 инструментов) - можно переключиться в режим только чтения |
Лимит в 100 запросов в день на Free считает только вызовы инструментов. Подключение, вход и получение списка инструментов не считаются. День определяется по часовому поясу, сохранённому в твоём аккаунте, и сбрасывается в полночь. Когда ты достигаешь лимита, ассистент получает сообщение об этом. Инструменты записи на Free и Basic отклоняются. При доступе по токену они отвечают, что подключение только для чтения, а для создания и правки нужен Pro и выше. При входе (OAuth) большинство из них отвечает «Insufficient scope», потому что подключения Free и Basic никогда не получают права на запись.
Экран в приложении
Открой Настройки > Интеграции, в разделе AI-агенты нажми AI-агенты (MCP). На экране написано: «Пусть ChatGPT, Claude и другие AI-ассистенты работают с твоими заметками, задачами и событиями TellDone.» Там же показан твой план:
- Free: «Твой план: доступ только на чтение, 100 запросов в день. Запись доступна на Pro.»
- Basic: «Твой план: доступ только на чтение»
- Pro и Ultra: «Твой план: доступ на чтение и запись»
Пока MCP выключен, нажми Включить, чтобы включить его.
После включения на экране появляется:
- Режим доступа (Pro и Ultra) - в любой момент выбери Только чтение или Чтение и запись.
- Подключить ассистента - шаги для ChatGPT, Claude и Другого ассистента. Ты входишь в TellDone прямо в ассистенте, поэтому токен не нужен.
- Подключённые приложения - ассистенты, которых ты подключил, у каждого кнопка Отключить. Список пуст до первого подключения.
- Для разработчиков (по умолчанию свёрнуто) - поле Токен доступа (скрыто, с кнопками Показать / Скрыть и Копировать), Перегенерировать токен и переключатель Claude Code / Cursor / Другое с готовым текстом и собственной кнопкой Копировать. Claude Code даёт команду
claude mcp add, Cursor даёт JSON для.cursor/mcp.json, а Другое перечисляет адрес сервера, вариант входа через OAuth и заголовокAuthorization: Bearer. Пока токен скрыт, в готовых фрагментах стоитYOUR_TOKEN. Нажми Показать, и в них появится твой настоящий токен.
В вебе те же элементы расположены иначе и без свёрнутого раздела для разработчиков: адрес OAuth с кнопкой Копировать, управление токеном, Подключённые приложения с кнопкой Отключить и Ручная настройка с bearer-токеном с шестью вариантами клиентов (Claude Code, Cursor, Windsurf, Codex, OpenClaw и cURL). В вебе фрагменты всегда содержат твой настоящий токен, даже когда поле токена скрыто, поэтому относись к ним так же бережно, как к самому токену.
- Документация - ссылка на эту страницу.
- Отключить - выключает MCP. Ты подтверждаешь: «Это отзовёт доступ у всех подключённых AI-инструментов.» Твой токен удаляется, и все подключения прекращаются. Если ты снова включишь MCP, ты получишь новый токен, а приложения, подключённые через вход (OAuth), снова заработают без повторного входа. Чтобы убрать приложение насовсем, нажми Отключить в разделе Подключённые приложения.
Не показывай никому свой токен доступа. Любой, у кого он есть, получает доступ к твоим данным TellDone. Если подозреваешь, что токен утёк, нажми Перегенерировать токен.
Как включить
Настроить MCP можно на любой платформе:
- iPhone: Настройки > Интеграции > AI-агенты (MCP)
- Веб: app.telldone.app > Настройки > Интеграции > AI-агенты (MCP)
Шаги:
- Нажми Включить.
- На Pro и Ultra выбери режим доступа (Только чтение или Чтение и запись). Free и Basic работают только на чтение.
- Чтобы подключить ChatGPT или Claude, нажми на него в разделе Подключить ассистента и следуй шагам (см. ниже). Токен не нужен.
- Для клиента для программирования на iPhone открой Для разработчиков, нажми Показать, выбери Claude Code, Cursor или Другое и нажми Копировать под фрагментом. Если скопировать до нажатия Показать, вместо токена в фрагменте будет
YOUR_TOKEN. В вебе выбери свой клиент в разделе Ручная настройка с bearer-токеном и скопируй фрагмент; в нём уже есть твой токен. - Вставь фрагмент в свой клиент или его файл конфигурации.
Подключение через OAuth
OAuth - рекомендуемый путь для ChatGPT, Claude и Cowork: ты входишь в свой аккаунт TellDone, а не копируешь токен.
MCP URL для OAuth: https://api.telldone.app/mcp/user
Тот же сервер отвечает и по адресу https://api.telldone.app/mcp/user/mcp, и оба адреса принимают bearer-токен. Для входа через OAuth используй первый.
ChatGPT
Свой MCP-сервер можно добавить на chatgpt.com или в приложении ChatGPT для компьютера. Мобильное приложение ChatGPT не умеет добавлять свои коннекторы, и приложение TellDone говорит об этом так: «В приложении ChatGPT коннекторы добавляются только из каталога.» Нажми Отправить инструкцию на компьютер в TellDone, чтобы получить инструкцию на компьютере. После добавления там TellDone становится доступен и в мобильном приложении ChatGPT.
Шаги в приложении:
- На компьютере открой chatgpt.com/plugins, нажми Add и выбери Add custom MCP server.
- Назови его TellDone, вставь адрес ниже (
https://api.telldone.app/mcp/user) и выбери OAuth. - Подтверди и установи его, затем войди в TellDone и разреши доступ.
Если названия пунктов меню изменятся, смотри руководство OpenAI по custom MCP servers.
Claude (сайт, Desktop, приложение для iPhone) / Cowork
Шаги в приложении:
- В Claude открой Customize → Connectors и нажми Add custom connector.
- Вставь адрес ниже (
https://api.telldone.app/mcp/user). - Войди в TellDone и разреши доступ.
Когда ты входишь, на странице согласия TellDone показано, какое приложение запрашивает доступ и какие именно разрешения ему нужны. Войди с email и паролем от TellDone и нажми Разрешить доступ либо нажми Войти с Apple или Войти через Google, и доступ будет подтверждён сразу на этом же шаге. Claude подключается сам - копировать токен не нужно.
Если названия пунктов меню изменятся, с мотри руководство Anthropic по добавлению своего коннектора.
Подключение с помощью bearer-токена
Для Claude Code, Cursor и других клиентов без встроенного входа через OAuth вставь токен доступа прямо в конфигурацию клиента. Во всех примерах ниже замени YOUR_TOKEN токеном из своих настроек.
Claude Code (bearer-токен)
claude mcp add --transport http telldone \
https://api.telldone.app/mcp/user/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Печатать это самому не нужно: в Настройки > Интеграции > AI-агенты (MCP) > Для разработчиков нажми Показать, выбери Claude Code и нажми Копировать. Скопированная команда уже содержит твой токен.
Cursor
Добавь в .cursor/mcp.json (или скопируй из Для разработчиков > Cursor после нажатия Показать):
{
"mcpServers": {
"telldone": {
"url": "https://api.telldone.app/mcp/user/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Другие клиенты
Настройки для других MCP-клиентов:
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-клиенты
Подключиться может любой инструмент, который поддерживает MCP по HTTP. Используй эндпоинт https://api.telldone.app/mcp/user/mcp с заголовком авторизации Bearer YOUR_TOKEN.
Если твой клиент или прокси занимает заголовок Authorization (например, некоторые шлюзы в стиле Smithery), отправляй токен в X-MCP-Token: YOUR_TOKEN. Работают оба заголовка; если присутствуют оба, приоритет у Authorization.
Проверка подключения
Проверить, что токен работает, можно простой командой 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}'
Успешный ответ содержит список всех доступных инструментов.
Разрешения (scopes)
Подключения OAuth ограничены по разрешениям: при входе ты видишь, что именно запрашивает клиент, и явно подтверждаешь это.
| Scope | Позволяет приложению... |
|---|---|
notes:read | Читать твои заметки и открывать их полное содержимое (инструменту search нужны также tasks:read и events:read) |
notes:write | Создавать, править и удалять заметки (process_note нужны также tasks:write и events:write) |
tasks:read / tasks:write | Читать / создавать, править, выполнять и удалять задачи |
events:read / events:write | Читать / создавать, править и удалять события |
reports:read | Читать твои ежедневные, еженедельные, ежемесячные и годовые отчёты |
tags:read / tags:write | Показывать твои теги / создавать, закреплять, удалять и восстанавливать теги |
profile:read | Читать информацию об аккаунте и подписке |
offline_access | Оставаться в системе (выдаёт токен обновления, чтобы не входить заново в каждой сессии) |
Разрешения ограничивают то, что может делать подключение: подключение только с notes:read не может вызвать инструмент записи. Твой план задаёт второе ограничение сверху.
Подключения с bearer-токеном не ограничиваются по отдельным разрешениям - ими управляет только режим чтения и записи твоего плана.
Что можно делать
Инструменты чтения (10) - все планы
| Инструмент | Что делает |
|---|---|
| get_notes | Показывает заметки с фильтрами (теги, период, текстовый поиск) |
| get_note | Показывает одну заметку с её дочерними задачами, событиями и полной расшифровкой |
| get_notes_full | Получает несколько заметок со встроенными задачами и собы тиями за один вызов |
| get_tasks | Показывает задачи с фильтром по статусу (к выполнению, выполнено, все), тегам или датам |
| get_events | Показывает события календаря, фильтр по периоду |
| get_reports | Читает твои ежедневные, еженедельные, ежемесячные и годовые отчёты (полный markdown) |
| get_tags | Показывает все твои теги, отсортированные по частоте использования |
| get_profile | Показывает информацию об аккаунте и сколько у тебя заметок, задач и событий |
| search | Ищет по заметкам, задачам и событиям (текстовый и семантический поиск для заметок) |
| get_change_log | Показывает историю правок заметки, задачи или события и то, отменена ли каждая правка |
Инструмент search поддерживает семантический поиск по заметкам: он находит результаты по смыслу, а не только по ключевым словам. Например, запрос «встречи про бюджет» найдёт заметки об обсуждении финансов, даже если в них нет слова «бюджет».
Инструменты записи (17) - 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 | Удаляет событие |
| undo_change_log_entry | Отменяет одну отслеживаемую правку (сделанную AI или тобой), возвращая прежнее значение поля |
| restore_entity | Возвращает удалённую или архивную заметку или задачу, либо удалённое или отменённое событие |
| create_tag | Создаёт новый тег или превращает автоматически предложенный тег в постоянный |
| set_tag_pinned | Закрепляет или открепляет тег, чтобы он стоял в начале списка |
| delete_tag | Удаляет тег (можно вернуть через restore_tag) |
| restore_tag | Возвращает удалённый тег |
Все операции записи и удаления сразу отображаются на твоих подключённых устройствах (телефон, веб-приложение).
Справочник по инструментам
get_notes
Показывает заметки с необязательной фильтрацией. Фильтры по дате используют recorded_at (когда ты записал голосовую заметку) или created_at для заметки, у которой его нет.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 20 | Сколько заметок вернуть (максимум 50) |
offset | int | 0 | Сколько заметок пропустить (для постраничного вывода, максимум 10000) |
tags | string | - | Фильтр по тегам через запятую (подходит любой) |
search | string | - | Текстовый поиск по названию и резюме |
date_from | string | - | Начальная дата, YYYY-MM-DD (включительно) |
date_to | string | - | Конечная дата, YYYY-MM-DD (не включая) |
standalone_only | bool | false | При true скрывает заметки-продолжения (прикреплённые к родительской заметке, задаче или событию) и возвращает только самостоятельные заметки |
Возвращает: список заметок с id, title, summary, type, tags, priority, status, recorded_at, created_at.
get_note
Получает одну заметку с полной расшифровкой и всеми связанными задачами и событиями.
| Parameter | Type | Description |
|---|---|---|
note_id | string | UUID заметки |
Возвращает: заметку с title, summary, transcript, type, tags, priority, status, metadata, created_at, а также массивы tasks[] и events[].
Также возвращает transcript_speakers (расшифровка с разметкой по говорящим, для встреч с несколькими голосами, иначе null), speaker_count (null, если запись не разделена по говорящим) и parent_note_id/parent_task_id/parent_event_id (задаются, когда эта заметка - продолжение с правкой другого элемента). Каждая запись в tasks[]/events[] также содержит reminders_at/recurrence_rule (задачи) или reminder_minutes/attendees/recurrence_rule (события).
get_notes_full
Получает несколько заметок с их задачами и событиями за один вызов. Те же фильтры, что у get_notes, кроме search, и каждая заметка содержит встроенные tasks[] и events[].
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 10 | Сколько заметок (максимум 20) |
offset | int | 0 | Сколько заметок пропустить |
tags | string | - | Фильтр по тегам |
date_from | string | - | Начальная дата, YYYY-MM-DD |
date_to | string | - | Конечная дата, YYYY-MM-DD |
standalone_only | bool | false | При true скрывает заметки-продолжения (прикреплённые к родительской заметке, задаче или событию) и возвращает только самостоятельные заметки |
get_tasks
Показывает задачи с фильтрацией.
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | "todo" | Фильтр: todo, done или all |
limit | int | 30 | Сколько задач (максимум 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, reminders_at, completed_at, completed_by, source, created_at. reminder_at повторяет первый элемент reminders_at для обратной совместимости; чтобы увидеть все напоминания задачи, используй reminders_at.
get_events
Показывает события календаря с фильтром по периоду.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | int | 30 | Сколько событий (максимум 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, note_id, reminder_minutes, attendees, recurrence_rule, created_at.
get_reports
Получает твои отчёты, созданные AI, с полным содержимым в markdown.
| Parameter | Type | Default | Description |
|---|---|---|---|
report_type | string | "daily" | Тип: daily, weekly, monthly или yearly |
limit | int | 5 | Сколько отчётов (максимум 10) |
Возвращает: список отчётов с id, type, period_start, period_end, content_md, created_at.
Ежемесячные отчёты длинные (часто заметно больше 1 000 слов). Если у твоего AI-инструмента небольшое окно контекста, используй limit=1.
get_tags
Получает все твои теги: сначала закреплённые, затем по числу использований.
Без параметров. Возвращает до 100 тегов, у каждого tag, usage_count, is_pinned, is_manual.
get_profile
Получает информацию об аккаунте и сколько у тебя заметок, задач и событий.
Без параметров. Возвращает email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at и stats (количество заметок, задач и событий).
search
Ищет сразу по заметкам, задачам и событиям. Для заметок поддерживает и текстовый, и семантический поиск (находит результаты по смыслу с помощью AI-эмбеддингов).
| Parameter | Type | Default | Description |
|---|---|---|---|
query | string | required | Текст запроса (максимум 500 символов) |
limit | int | 20 | Максимум результатов каждого типа (максимум 20) |
semantic | bool | true | Включить семантический поиск по заметкам |
Возвращает результаты, сгруппированные по типам: notes[], tasks[], events[]. У каждого результата есть id, type, title, detail, created_at.
Задай semantic=false для более быстрого поиска только по тексту.
get_change_log
Показывает историю правок заметки, задачи или события: каждую правку-продолжение, сделанную AI, и каждую правку, которую ты внёс сам, сначала новые.
| Parameter | Type | Default | Description |
|---|---|---|---|
entity | string | required | notes, tasks или events |
entity_id | string | required | UUID элемента |
include_manual | bool | false | Включить также твои собственные ручные правки, а не только сделанные AI |
Возвращает: список записей об изменениях с id (используй его как entry_id для отмены), field_name, old_value, new_value, source (follow_up, smart_context, correction_sync для исправления имени, которое TellDone перенёс по заметке, или manual), origin_note_id, edited_at и reverted_at (задаётся после отмены).
process_note (Pro и Ultra)
Полный AI-конвейер: работает так же, как запись в приложении. Отправь текст или аудио, и TellDone расшифрует его, проанализирует с помощью AI и создаст структурированную заметку с извлечёнными задачами, событиями, тегами и эмбеддингами.
Этот инструмент асинхронный: он сразу возвращает audio_id и обрабатывает данные в фоне. Результаты приходят на твои подключённые устройства через синхронизацию в реальном времени, или можно опрашивать через get_notes().
| Parameter | Type | Description |
|---|---|---|
text | string | Обязательно. Текст для анализа. Если он не пустой, он используется как расшифровка, а отправленное аудио не расшифровывается; отправь "", чтобы аудио было расшифровано. Лимит, когда аудио не отправляется: Pro 20 000 / Ultra 50 000 символов |
audio_base64 | string | Аудиофайл в кодировке Base64. Весь запрос ограничен 10 МБ, поэтому само аудио может быть около 7 МБ. Расшифровывается, только когда text пуст |
audio_format | string | m4a, ogg, wav, mp3, aac или webm (по умолчанию: m4a) |
parent_task_id | string | UUID задачи, к которой это продолжение |
parent_note_id | string | UUID заметки, к которой это продолжение |
parent_event_id | string | UUID события, к которому это продолжение |
Всегда отправляй text. Чтобы TellDone расшифровал аудио, отправь audio_base64 и задай text пустой строкой (""). Если text не пустой, TellDone использует его как расшифровку и не расшифровывает аудио. Задай не больше одного из трёх родительских ID.
Возвращает: {"audio_id": "...", "status": "processing", "mode": "text-only"} или "mode": "audio+stt", если было передано аудио.
process_note подчиняется квотам твоего плана (загрузок в день, заметок в месяц, максимальная длина текста). get_profile показывает только количество заметок, задач и событий, а не твои лимиты. Использование можно проверить в приложении: Настройки > Использование.
create_note (Pro и Ultra)
Мгновенно создаёт простую текстовую заметку. AI-анализ не запускается: задачи и события не извлекаются. Используй process_note, когда хочешь, чтобы TellDone сам нашёл задачи и события.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 симв. | Обязательно |
summary | string | 1000 симв. | Необязательно. Короткий анонс (1-3 предложения). Используется в твоих отчётах, поэтому делай его коротким |
transcript | string | по плану | Необязательно. Длинный основной текст, показывается в подробностях заметки. В отчёты не попадает. Лимиты: Pro 20 000 / Ultra 50 000 симв. |
type | string | - | Необязательно. task, idea, info (по умолчанию), status, meeting, event или reflection |
tags | string | 20 тегов | Через запятую, необязательно |
suppress_external_sync | boolean | - | Необязательно, по умолчанию false. Задай true для импортированных или массово создаваемых элементов: тогда элемент не отправляется в твои подключённые приложения и автоматизации |
create_task (Pro и Ultra)
Создаёт новую задачу. Задача также создаётся в подключённых Todoist, Notion или Microsoft To Do, а твои автоматизации получают task.created. Этого не происходит, если передать suppress_external_sync: true.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 симв. | Обязательно |
description | string | 2000 симв. | Необязательно |
priority | string | - | low, medium (по умолчанию) или high |
deadline | string | - | YYYY-MM-DD, необязательно |
reminder_at | string | - | Дата и время ISO 8601 (например, 2026-04-15T09:00:00Z), необязательно |
tags | string | 20 тегов | Через запятую, необязательно |
note_id | string | - | UUID для привязки задачи к родительской заметке, необязательно |
suppress_external_sync | boolean | - | Необязательно, по умолчанию false. Задай true для импортированных или массово создаваемых элементов: тогда элемент не отправляется в твои подключённые приложения и автоматизации |
create_event (Pro и Ultra)
Создаёт событие календаря. Событие также создаётся в подключённом Notion, а твои автоматизации получают calendar_event.created. Этого не происходит, если передать suppress_external_sync: true.
| Parameter | Type | Limit | Description |
|---|---|---|---|
title | string | 200 симв. | Обязательно |
start_at | string | - | Дата и время ISO 8601, обязательно |
end_at | string | - | Дата и время ISO 8601 (по умолчанию: начало + 1 час; для события на весь день - один день) |
description | string | 2000 симв. | Необязательно |
location | string | 200 симв. | Необязательно |
is_all_day | bool | - | По умолчанию: false |
tags | string | 20 тегов | Через запятую, необязательно |
reminder_minutes | string | - | Минуты до события через запятую (например, 15,60), необязательно |
attendees | string | - | Имена или email через запятую, необязательно |
recurrence_rule | string | - | Строка RRULE (например, FREQ=WEEKLY;BYDAY=MO,WE,FR), необязательно. Правила чаще чем раз в час и те, которые не могут выполниться никогда, отклоняются |
note_id | string | - | UUID для привязки события к родительской заметке, необязательно |
suppress_external_sync | boolean | - | Необязательно, по умолчанию false. Задай true для импортированных или массово создаваемых элементов: тогда элемент не отправляется в твои подключённые приложения и автоматизации |
update_note (Pro и Ultra)
Обновляет одно или несколько полей существующей заметки. Меняются только указанные поля. Это работает точно так же, как правка заметки в приложении: название, резюме, теги и тип попадают на её страницу в Notion, твои автоматизации получают note.updated, а правка появляется в истории изменений, где её можно отменить. Изменённая расшифровка тоже сохраняется и отправляется в Notion, но в историю не попадает.
| Parameter | Type | Description |
|---|---|---|
note_id | string | Обязательно, UUID заметки |
title | string | Новое название (максимум 200 симв.) |
summary | string | Новое резюме (максимум 1000 симв., передай пробел " ", чтобы очистить) |
transcript | string | Новая расшифровка (лимит по плану, передай пробел " ", чтобы очистить) |
type | string | task, idea, info, status, meeting, event или reflection |
tags | string | Теги через запятую (заменяют все существующие теги, максимум 20) |
priority | string | low, medium или high |
status | string | active или archived |
У заметок, созданных голосовым конвейером, transcript - это исходный результат распознавания речи. Перезапись заменяет твои оригинальные слова. Чтобы их сохранить, дополняй расшифровку, а не заменяй её.
update_task (Pro и Ultra)
Обновляет одно или несколько полей существующей задачи. Меняются только указанные поля. Это работает точно так же, как правка задачи в приложении: изменение попадает в её копии в Todoist, Notion и Microsoft To Do, твои автоматизации получают task.updated, а правка появляется в истории изменений задачи, где её можно отменить. Если задать status равным done, задача выполняется так же, как через complete_task. Срок можно указать датой или полной датой со временем (используется дата). Каждый тег может быть длиной до 50 символов.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Обязательно, UUID задачи |
title | string | Новое название |
description | string | Новое описание (передай пробел " ", чтобы очистить) |
priority | string | low, medium или high |
deadline | string | YYYY-MM-DD. Этот инструмент не может убрать срок; сделай это в приложении |
status | string | todo или done |
tags | string | Теги через запятую (заменяют все существующие теги, максимум 20) |
reminder_at | string | Дата и время ISO 8601 (передай пробел, чтобы очистить) |
Если задать status равным done, также записывается, когда и как задача была выполнена.
complete_task (Pro и Ultra)
Быстрый способ отметить задачу выполненной.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Обязательно, UUID задачи |
Возвращает ошибку, если задача не существует или уже выполнена.
update_event (Pro и Ultra)
Обновляет одно или несколько полей существующего события. Меняются только указанные поля. Это работает точно так же, как правка события в приложении: изменение попадает на его страницу в Notion, твои автоматизации получают calendar_event.updated, а правка появляется в истории изменений, где её можно отменить.
| Parameter | Type | Description |
|---|---|---|
event_id | string | Обязательно, UUID события |
title | string | Новое название |
description | string | Новое описание (передай пробел, чтобы очистить) |
start_at | string | Новое время начала (ISO 8601) |
end_at | string | Новое время окончания (ISO 8601) |
location | string | Новое место (передай пробел, чтобы очистить) |
status | string | confirmed, tentative или cancelled |
tags | string | Теги через запятую (заменяют все существующие теги, максимум 20) |
is_all_day | string | "true" или "false" |
reminder_minutes | string | Минуты до события через запятую (например, 15,60, передай пробел, чтобы очистить) |
attendees | string | Имена или email через запятую (передай пробел, чтобы очистить) |
recurrence_rule | string | Строка RRULE (передай пробел, чтобы очистить) |
delete_note (Pro и Ultra)
Удаляет заметку. Удаляется только сама заметка: её задачи и события остаются. Это работает точно так же, как удаление в приложении: твои автоматизации получают note.deleted. Копия заметки в Notion не удаляется (прило жение её тоже не удаляет).
| Parameter | Type | Description |
|---|---|---|
note_id | string | Обязательно, UUID заметки |
delete_task (Pro и Ultra)
Удаляет задачу. Это работает точно так же, как удаление в приложении: её копии в Todoist, Notion и Microsoft To Do тоже удаляются, а твои автоматизации получают task.deleted. Вернуть задачу можно через restore_entity.
| Parameter | Type | Description |
|---|---|---|
task_id | string | Обязательно, UUID задачи |
delete_event (Pro и Ultra)
Удаляет событие. Это работает точно так же, как удаление в приложении: твои автоматизации получают calendar_event.deleted. Страница события в Notion не удаляется (приложение её тоже не удаляет).
| Parameter | Type | Description |
|---|---|---|
event_id | string | Обязательно, UUID события |
undo_change_log_entry (Pro и Ultra)
Отменяет одну отслеживаемую правку: возвращает полю значение, которое было до неё, независимо от того, сделала правку AI (из записи-продолжения) или ты сам.
| Parameter | Type | Description |
|---|---|---|
entity | string | Обязательно, notes, tasks или events |
entity_id | string | Обязательно, UUID элемента |
entry_id | string | Обязательно, id записи об изменении из get_change_log |
Возвращает: {"entry_id", "entity_type", "entity_id", "field_name", "restored_value", "reverted_at"}. Повторная отмена той же записи возвращает ошибку: она уже отменена.
restore_entity (Pro и Ultra)
Возвращает удалённую или архивную заметку или задачу, либо удалённое или отменённое событие.
| Parameter | Type | Description |
|---|---|---|
entity | string | Обязательно, notes, tasks или events |
entity_id | string | Обязательно, UUID элемента |
Возвращает: восстановленный элемент в виде JSON.
create_tag (Pro и Ultra)
Создаёт новый тег или превращает существующий автоматически предложенный тег в постоянный.
| Parameter | Type | Description |
|---|---|---|
tag | string | Обязательно, 1-50 символов (хранится в нижнем регистре) |
category | string | Необязательно |
set_tag_pinned (Pro и Ultra)
Закрепляет или открепляет тег, чтобы он стоял в начале списка тегов.
| Parameter | Type | Description |
|---|---|---|
tag | string | Обязательно |
pinned | bool | Обязательно |
Т еги, содержащие символ /, закрепить нельзя.
delete_tag (Pro и Ultra)
Удаляет тег. Его можно вернуть через restore_tag.
| Parameter | Type | Description |
|---|---|---|
tag | string | Обязательно |
restore_tag (Pro и Ultra)
Возвращает удалённый тег.
| Parameter | Type | Description |
|---|---|---|
tag | string | Обязательно |
Ограничения на ввод
| Field | Max length | Used in |
|---|---|---|
| title | 200 символов | create/update note, task, event |
| description | 2 000 символов | create/update task, event |
| summary | 1 000 символов (жёстко) | create/update note. Используется в твоих о тчётах, поэтому делай его коротким |
| transcript | по плану: Pro 20 000 / Ultra 50 000 | create/update note. Длинный основной текст, в отчёты не попадает |
| text | по плану: Pro 20 000 / Ultra 50 000 (когда аудио не отправляется) | process_note |
| location | 200 символов | create/update event |
| tags | 20 тегов | create/update note, task, event |
| search query | 500 символов | search |
| audio_base64 | около 7 МБ аудио (весь запрос ограничен 10 МБ) | process_note |
Если превысить лимит, инструмент вернёт сообщение об ошибке вроде "title too long (max 200 chars, got 250)".
Обработка ошибок
Большинство инструментов возвращают ошибки в виде JSON:
{"error": "description of what went wrong"}
Ошибки плана, разрешений и ограничений на ввод приходят как ошибка инструмента с тем же сообщением.
Частые ошибки:
| Error | When |
|---|---|
"This TellDone connection is read-only. Creating and editing needs the Pro or Ultra plan." | Вызван инструмент записи в режиме только чтения (Free и Basic или Pro и Ultra, переключённые в режим только чтения) |
"Daily limit reached: the Free plan includes 100 TellDone requests a day..." | План Free исчерпал 100 запросов за день |
"Daily limit reached (N/M today)" | Ты создал через AI-ассистентов сегодня столько элементов, сколько позволяет план (считаются process_note, create_note, create_task и create_event) |
"Notes limit reached (X/Y this month)" | Месячный лимит заметок твоего плана исчерпан |
"Invalid note_id format" | В качестве ID передана строка, не являющаяся UUID |
"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 тегов |
Ошибки уровня HTTP:
| Code | Meaning |
|---|---|
| 401 | Недействительный, отозванный или удалённый токен (отключение MCP удаляет твой токен, а пересоздание заменяет его) |
| 429 | Превышен лимит запросов (5 запросов в секунду, всплески до 20) |
На Free достижение лимита в 100 запросов в день сообщается сообщением об ошибке инструмента (а не HTTP-кодом) и сбрасывается в полночь по часовому поясу, сохранённому в твоём аккаунте.
Примеры использования
Во всех примерах используется cURL с протоколом MCP JSON-RPC. Замени YOUR_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 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>"}}}'
Успешный ответ выглядит так:
{
"jsonrpc": "2.0",
"id": 11,
"result": {
"content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
}
}
Инструменты записи и обновления возвращают короткие ответы, в основном id, title и status. Инструменты удаления возвращают id и deleted. Чтобы получить полные сведения (теги, приоритет, срок и т. д.) после записи, сделай дополнительный вызов чтения, например get_tasks или get_note.
Управление токеном
| Действие | Как |
|---|---|
| Посмотреть токен | iPhone: Настройки > Интеграции > AI-агенты (MCP) > Для разработчиков (или в вебе: Настройки > Интеграции > AI-агенты (MCP)), нажми Показать |
| Скопировать токен | Нажми Копировать рядом с токеном |
| Перегенерировать токен | Нажми Перегенерировать токен и подтверди. Старый токен перестаёт работать сразу. Ассистенты, подключённые через вход OAuth, это не затрагивает; отключай их в разделе Подключённые приложения |
| Сменить режим | Pro и Ultra: выбери Только чтение или Чтение и запись. Free и Basic всегда работают только на чтение |
| Отключить | Нажми Отключить и подтверди («Это отзовёт доступ у всех подключённых AI-инструментов.»). Твой токен удаляется, и все подключения прекращаются. Если ты снова включишь MCP, ты получишь новый токен, а приложения, подключённые через вход (OAuth), снова заработают без повторного входа. Чтобы убрать приложение насовсем, нажми Отключить в разделе Подключённые приложения |
Что можно спросить у своего AI-агента
После подключения спрашивай свой AI-инструмент о таком:
Обзор дня:
- «Над чем я сегодня работал?»
- «Покажи мои заметки за эту неделю»
- «Какие задачи просрочены?»
Управление задачами:
- «Создай задачу: проверить квартальный отчёт, высокий приоритет, срок - пятница»
- «Отметь задачу про Figma выполненной»
- «Над какими задачами я работаю?»
Поиск и анализ:
- «Найди все заметки про маркетинговую стратегию»
- «Какие у меня события на следующей неделе?»
- «Подведи итоги моих ежедневных отчётов за прошлую неделю»
Планирование:
- «Создай событие: планёрка завтра в 10 утра»
- «Что у меня в календаре на этой неделе?»
- «Покажи мои самые частые теги - на что я трачу больше всего времени?»
Твой ассистент может читать твои заметки, задачи, события и отчёты и отвечать на сложные вопросы, объединяя информацию из нескольких инструментов. На Pro и Ultra с включённым режимом «Чтение и запись» он также может создавать, обновлять и удалять их.
Хорошо знать
- Интеграции и автоматизации -
process_noteработает как запись, поэтому его заметка, задачи и события попадают в твои подключённые интеграции и вебхук-автоматизации. Элементы, котор ые ты создаёшь, меняешь или удаляешь другими инструментами записи, ведут себя точно так же, как в приложении: они попадают в твои подключённые интеграции (события и правки заметок - только в Notion) и в твои автоматизации. Восстановление задачи черезrestore_entityили отмена её выполнения черезundo_change_log_entryтакже снова открывает её в интеграциях, с которыми она была синхронизирована. - Правки через AI-ассистента - в истории изменений элемента они помечаются как сделанные ассистентом. Они не используются для обучения распознавания речи TellDone и не копируются в другие элементы заметки. Правки через ассистента делят с приложением общий лимит: 30 правок в минуту.
- Семантический поиск - заметки, созданные через
process_noteилиcreate_note, получают эмбеддинги, поэтому появляются в семантическом поиске с небольшой задержкой. - Фильтры по дате - для заметок даты считаются по дням UTC. Для событий даты - твои локальные дни, и событие, пересекающееся с периодом, включается. Для задач фильтр - дата срока.
Безопасн ость
- Каждый пользователь получает уникальный 384-битный токен доступа
- Твой токен мгновенно отзывается, когда ты выключаешь MCP или создаёшь токен заново
- Каждый запрос привязан к твоему аккаунту, поэтому твой агент имеет доступ только к твоим данным
- Подключение использует HTTPS с ограничением частоты запросов (5 запросов в секунду, всплески до 20)
- Подключения OAuth используют PKCE с одноразовыми кодами авторизации и недолговечными токенами доступа - подключение можно отозвать в любой момент из приложения
Подробное техническое описание - эндпоинты обнаружения, сроки жизни токенов, полный процесс OAuth - смотри в нашем открытом справочнике по коннектору github.com/exp78/telldone-mcp или запроси напрямую https://api.telldone.app/.well-known/oauth-protected-resource.
Конфиденциальность и поток данных
Подключённый AI-инструмент получает твои данные, только когда обращается к TellDone, обычно потому что ты его о чём-то спросил. Он получает только ответы на эти вызовы и только в рамках разрешений, которые ты подтвердил. Чтобы ограничить доступ, переключись на Только чтение, отключи приложение в разделе Подключённые приложения либо создай заново или выключи токен доступа в настройках. Подробности смотри в Политике конфиденциальности или пиши на support@telldone.app, если остались вопросы.
Если что-то не работает
| Симптом | Причина / решение |
|---|---|
| На странице согласия OAuth написано «Wrong email or password» | Используй email и пароль, с которыми входишь в приложение, или выбери Войти с Apple / Войти через Google на той же странице. |
| Подключено, но AI ничего не может создать или изменить | У тебя план Free или Basic (только чтение), включён режим только чтения или у подключения нет прав на запись. Если ты подключился до перехода на платный план, отключи приложение в разделе Подключённые приложения и подключи его заново. Свой режим можно проверить в настройках. |
| Ошибка «Insufficient scope» от инструмента | У подключения нет этого разрешения. На Free и Basic права на запись не выдаются никогда, поэтому для создания и правки нужен Pro или Ultra. Если ты подключился до перехода на платный план, отключи приложение в разделе Подключённые приложения и подключи его заново. |
Скопированный фрагмент содержит YOUR_TOKEN, и клиент не может подключиться | Ты скопировал его, пока токен был скрыт. В разделе Для разработчиков нажми Показать и скопируй фрагмент ещё раз. |
| Инструменты вообще не появляются | MCP не включён в твоём аккаунте (Настройки > Интеграции > AI-агенты (MCP) > Включить). |
| «Daily limit reached» | Это сообщение используют два лимита. «Daily limit reached: the Free plan includes 100 TellDone requests a day» - лимит запросов на Free. «Daily limit reached (N/M today)» означает, что ты создал через AI-ассистентов сегодня столько элементов, сколько позволяет план: process_note, create_note, create_task и create_event считаются, в том числе на Pro и Ultra. Оба лимита сбрасываются в полночь по часовому поясу, сохранённому в твоём аккаунте. |
| Мой клиент позволяет выбирать только из списка коннекторов, а TellDone в нём нет | TellDone пока нет в каталоге коннекторов ни одного клиента - добавь его как свой коннектор с MCP URL или используй способ с bearer-токеном. |
Смотри также
- Вебхук-автоматизации - автоматическая отправка данных во внешние сервисы
- Todoist - отдельная двусторонняя синхронизация задач
- Notion - отдельная интеграция с Notion