nicolascroce/keepsake-mcp

Преобразует QuickNote в постоянную Note (архивирует). Notes отображаются на страницах контактов, страницах тегов и в разделе Notes.

Отмечает задачу как выполненную. Если задача повторяющаяся, это автоматически создаёт следующее повторение.

Создаёт новую компанию/организацию. Требуется только 'name'.

Создаёт новый контакт. first_name обязателен. last_name необязателен (полезно для контактов, где известно только имя).

Создаёт временной блок на временной шкале дня. Блок автоматически помещается в первый свободный промежуток, достаточно большой для него (тот же алгоритм first-fit, что и в приложении); передайте anchor_time, чтобы вместо этого закрепить его на фиксированном часе. Его ссылка "b:<id>" вставляется в timeline_order дня за вас — никогда не пишите timeline_order вручную.

ЗАПИСЬ — это журнал взаимодействий с указанием даты, привязанный к контактам. Записывает что-то, что произошло (звонок, встреча, электронное письмо и т.д.) на определенную дату. Создает новую запись взаимодействия. Содержимое поддерживает синтаксис #tag# и [[tag]] для автоматического связывания тегов.

Создаёт новую QuickNote в Inbox. QuickNotes - временные заметки: используйте archive_note, чтобы превратить одну из них в постоянную Note. Содержимое поддерживает #tag# и [[tag]] для автоматической привязки тегов. Передайте dates, чтобы привязать заметку к одному или нескольким дням («заметка на завтра», подготовка к встрече в четверг): тогда она появится в представлении этого дня, оставаясь в списке заметок. Заметка с датой - НЕ задача (не требует выполнения) и НЕ намерение дня (см. update_day).

Пиши на полях заметки. Это правильное действие всякий раз, когда пользователь просит тебя проверить, оценить, вычитать или откомментировать его текст: замечание располагается рядом с заметкой, не проникая в неё, и остаётся там после завершения разговора — в отличие от всего, что ты пишешь в чате. Привяжи замечание к фрагменту, скопировав этот фрагмент ДОСЛОВНО в quote; сервер находит его и сохраняет окружающий контекст, так что комментарий переживает последующие правки. Опусти quote, чтобы оставить замечание ко всей заметке в целом. Цитата, не найденная дословно, отклоняется, а не прикрепляется к неверному месту. Твои комментарии в приложении отображаются синими чернилами, а пользователя — красными; они всегда знают, кто что написал. Не используй это для переписывания их текста: предлагай, они решают. И оставляй комментарии редкими и содержательными: заметка, усеянная ими, — это заметка, которую пользователь бросает.

Заставляет временной блок повторяться в выбранные дни недели. Два способа: передать block_id, чтобы превратить СУЩЕСТВУЮЩИЙ блок в повторяющийся (он становится первым вхождением и сохраняет своё название, длительность и фиксированное время - делайте это, когда блок уже на таймлайне, иначе в этот день он появится дважды), или описать новый (название, длительность, необязательное фиксированное время) начиная с start_date. На таймлайне ничего не создаётся сразу: блок каждого дня появляется, когда этот день открывают в приложении или выводят через list_day_blocks. С anchor_time блок стоит на этом часе каждый день; без него он ставится от времени пробуждения пользователя и сдвигается вместе с ним.

TAG — это пространство для тематической группировки. Синтаксис: #name# или [[name]]. Группирует заметки, записи, задачи и контакты. Создаёт новый тег. Если тег с таким же именем уже существует, возвращает существующий тег.

ЗАДАЧА - это действие, которое нужно выполнить. Может иметь срок выполнения, периодичность, приоритет, быть связана с контактами и тегами. Создайте новую задачу. Название поддерживает #tag# и [[tag]] для автоматической привязки тегов.

Создаёт новый заголовок задачи (разделитель секции). Чтобы показать его на странице тега, вставляет "h:<header_id>" в tasks_order этого тега (get_tag, затем update_tag) там, где должна начинаться секция: задачи, перечисленные после него, принадлежат этой секции.

Мягко удаляет компанию. Для жёсткого удаления используйте permanent=true.

Окончательно удаляет контакт и все связанные данные.

Удаляет временной блок. Его ref вырезается из timeline_order за день; для бакета задач сами задачи не трогаются (они откатываются к вычисленному для дня бакету). Для повторяющегося блока это удаляет его ТОЛЬКО ИЗ ЭТОГО ДНЯ (в приложении это "Remove from today"): блок продолжает возвращаться в остальные дни, и пропущенный день не прерывает серию привычки. Чтобы остановить само повторение, используйте stop_recurring_block.

Удаляет запись взаимодействия.

Мягко удаляет QuickNote или Note. Используйте permanent=true для жёсткого удаления.

Удаляет маргиналию. Маргиналии по своей природе временны, поэтому это штатный способ завершить её существование — промежуточное состояние, пригодное для восстановления, отсутствует.

Удаляет навсегда тег и все его связи с контактами, записями, задачами, заметками и компаниями.

Удаляет задачу.

Безвозвратно удаляет заголовок задачи.

Получает лучшие практики и инструкции для эффективной работы в роли агента Keepsake AI. Вызывай этот инструмент в начале каждого сеанса, чтобы обновить свои инструкции.

Получает все элементы, изменённые с указанной временной метки, по всем типам сущностей. Отлично подходит для heartbeat-проверок, чтобы увидеть, что изменилось с вашего последнего визита. Возвращает server_time для использования в качестве since при следующем вызове.

Получает одну компанию по ID, включая связанные контакты (с ролями) и теги.

Получает один контакт по ID, включая последние записи (взаимодействия), теги, дату последнего взаимодействия и количество total_entries.

Получает унифицированную хронологическую ленту ВСЕХ элементов, связанных с контактом — записей, задач и заметок — отсортированных по дате (сначала новые). Гораздо эффективнее, чем получать записи, задачи и заметки по отдельности.

Получает конкретный день по дате: его намерение или вопрос дня И заметки, привязанные к этому дню (поле notes, через link_note_date / dates). note - это намерение, записанное для этого дня (null или '' = нет; intention повторяет его). Намерение действительно только для своего дня - оно не переносится на другие. Всегда 200 - exists: false означает, что для этой даты нет сохранённой строки; intention и привязанные заметки возвращаются в любом случае.

Получает одну заметку по ID, включая её теги, связанные контакты, связанные задачи, связанные заметки и дни, с которыми она связана (dates). Используйте этот инструмент, когда пользователь указывает на одну конкретную заметку (например, даёт её URL: UUID - последний сегмент пути), вместо перечисления всех заметок.

Получает один тег по идентификатору со всеми его свойствами (название, описание, цвет, иконка, режим просмотра, статус избранного). Включает tasks_order — ручную сортировку списка задач на странице тега, где записи вида "h:<header_id>" являются разделителями разделов (см. list_task_headers).

Получает элементы, связанные с тегом. По умолчанию возвращает каждый тип полностью — для больших тегов это может быть огромным ответом, поэтому лучше использовать types/status/summary, чтобы сузить его (например, types=['tasks'], status='pending', summary=true для просмотра открытых задач проекта). Когда включены задачи, ответ также содержит sections: разделы задач на странице тега с их task_ids (header_id null = задачи вне любого раздела).

Получает одну задачу по ID вместе с её тегами, связанными контактами (contact_ids), связанными компаниями (company_ids) и связанными заметками (note_ids). Используйте его, когда уже знаете, какая задача нужна, вместо того чтобы перечислять всё.

Получает один заголовок задачи по идентификатору.

Получает только просроченные задачи (незавершенные задачи со сроком выполнения до сегодняшнего дня). Сортирует по дате по возрастанию (сначала самые старые).

Получает все задачи на сегодня: просроченные задачи + задачи со сроком на сегодня + задачи ASAP. Каждая задача имеет поле 'category' ('overdue', 'today' или 'asap'). Включает количество по каждой категории.

Привязывает контакт к записи компании (идемпотентно: при повторной привязке остаётся одна связь). Контакт может принадлежать нескольким компаниям. Дополнительно задаёт роль контакта в компании. Короткий путь, когда известно только название компании: create_contact / update_contact с company.

Привязывает компанию к записи (компания становится участником этого взаимодействия). Идемпотентно. Компании хранятся отдельными записями, не как контакты: используйте этот инструмент (или company_ids) для организации, а link_entry_contact - для человека.

Связывает существующий контакт с записью.

Привязывает компанию к заметке. Идемпотентно. Компании - это отдельные записи, не контакты: используйте этот инструмент (или company_ids) для организации, link_note_contact - для человека.

Привязывает существующий контакт к заметке.

Связывает заметку с календарным днём. Затем заметка появляется в представлении этого дня (Today / Day page), оставаясь в списке заметок. Заметка остаётся тем же объектом, а дата - просто ещё один способ попасть в неё. Используйте её для «заметки на завтра», «что взять с собой в четверг», подготовки к встрече на конкретную дату. Операция идемпотентна. Заметку можно связать с несколькими днями. Это НЕ намерение дня (update_day) и НЕ задача (create_task).

Свяжите две заметки друг с другом (база знаний, N-N, неразрушающая). Связь симметрична: обе заметки отображают друг друга в разделе связанных заметок. Используйте это, чтобы соединять связанные идеи - например, заметку, которая натолкнула вас на другую. Заметки также можно связывать внутри текста, написав label в содержимом заметки.

Связывает сущность (контакт, запись, задачу, заметку или компанию) с тегом.

Привязывает компанию к задаче. Идемпотентно. Компании - это отдельные записи, не контакты: используйте этот инструмент (или company_ids) для организации, link_task_contact - для человека.

Привязывает существующий контакт к задаче.

Связывает существующую заметку с задачей (неразрушающе, многие-ко-многим). Заметка остаётся в списке входящих/заметок, а задача сохраняет живую ссылку на неё - используйте это вместо удаления заметки после создания из неё задачи. Заметка показывает связанные с ней задачи; задача показывает исходную заметку.

Перечисляет все компании/организации в Keepsake CRM пользователя. Поддерживает пагинацию и сортировку.

Выводит список контактов в Keepsake CRM пользователя. Поддерживает постраничную навигацию, сортировку, выбор полей (используйте fields, чтобы пропускать длинные заметки при просмотре множества контактов), фильтры по связанным компаниям и по последнему обновлению, а также необязательное обогащение last_interaction_date. Компании каждого контакта - это записи компаний, возвращаемые в companies.

Перечисляет временные блоки таймлайна дня (Day view) в порядке таймлайна. Блок - это либо активность (тип 'block'), либо корзина задач (тип 'tasks' - группирует задачи дня без привязки ко времени). В meta лежит сырой timeline_order дня: ссылки "b:<uuid>" - это блоки, голые uuid - задачи внутри прогона корзины. Повторяющиеся блоки: при перечислении сегодняшнего или будущего дня сначала создаются повторяющиеся блоки этого дня, если их ещё нет (так же, как при открытии дня в приложении), поэтому у каждого возвращённого блока есть настоящий id, который можно обновить или отметить выполненным. Повторяющийся блок несёт repeats: { recurring_block_id, weekdays } (ISO-дни недели, 1 = понедельник … 7 = воскресенье); иначе repeats равен null. Прошедшие дни задним числом никогда не заполняются.

Перечисляет сохранённые дни с их намерением или вопросом дня (note; intention повторяет его, null, когда пусто). Намерение действительно только для своего дня - оно не переносится на следующие дни. Фильтрует по диапазону дат.

Перечисляет записи взаимодействий (звонки, письма, встречи, события и т. д.). Поддерживает фильтрацию по типу, контакту, компании, тегу (странице) и диапазону дат.

Перечисляет маргиналии, прикреплённые к заметке. Маргиналия — это рабочий материал, который пользователь хранит РЯДОМ с заметкой, не внося его в текст: идея, отсылка, ссылка, отрывок, вставленный для последующей переработки фрагмента. Они никогда не публикуются и предназначены быть ВРЕМЕННЫМИ: всё, что стоит сохранить, становится заметкой или связанной задачей. Каждая из них прикреплена либо к определённому фрагменту (quote задано), либо ко всей заметке (quote равно null).

Выводит список заметок. QuickNotes (входящие, ещё не заархивированные) и Notes (архивные, постоянные). Фильтрует по тому, закреплена заметка или заархивирована, по тегу (странице) через tag_id, по дню (дням), к которым привязана заметка (date или date_from/date_to), например «что я записал на завтра?», или по стадии публикации через status, например «какие заметки ждут проверки?». У каждой заметки есть dates (дни, к которым она привязана) и status (её стадия в процессе публикации или null).

Перечисляет этапы потока публикации пользователя по порядку (по умолчанию: Идея → В работе → На проверку → Готово → Опубликовано). Заметка попадает в этот поток, когда пользователь может её опубликовать - большинство заметок в него не попадает и этапа не имеет. Этапы принадлежат пользователю: он может переименовывать их, менять цвет, добавлять или удалять, поэтому прочитайте этот список, прежде чем задавать этап с помощью update_note или create_note. category фиксирована: unstarted, started или published (ровно один этап). Названия даны на языке приложения пользователя.

Перечисляет повторяющиеся временные блоки пользователя: свой идеальный день / свою идеальную неделю ("Meditation" каждый день в 08:00, "Writing" по утрам в будни). Повторяющийся блок - это ещё и привычка: каждый день он появляется на таймлайне как обычный блок, который пользователь отмечает (см. list_day_blocks), а последовательные отмеченные дни образуют серию. weekdays - это правило, действующее на заданную дату; next_change сообщает о правиле, уже записанном на будущее (повторение, которое начинается или прекращается в будущую дату).

Перечисляет теги (облегчённое представление: массивы ручной сортировки задач опущены — для получения полного порядка используйте get_tag). Теги организуют контакты, записи, задачи, заметки и компании. Используйте q для поиска тега по имени.

Перечисли все заголовки задач (разделители разделов, используемые для группировки задач на страницах тегов и в дневных представлениях).

Выводит список задач. Фильтрует по status (pending/completed), date_type, конкретной дате, company или tag (page). Например, tag_id + status=pending выводит открытые задачи проекта.

Объединяет компанию-дубликат В другую: её контакты, записи и теги перемещаются в целевую компанию (без дубликатов), пустые поля целевой компании (сайт, email, телефон, адрес) заполняются из неё, её заметки добавляются к заметкам целевой компании, после чего она удаляется. Используйте его, когда две записи описывают одну и ту же организацию (например, 'CNCP' и 'Cncp'). Уточните у пользователя, какую запись оставить.

Закрепляет QuickNote или Note, чтобы заметка оставалась на виду. Закреплённая заметка - это POST-IT: короткая справка, которую пользователь хочет всегда держать под рукой (код от ворот, номер комнаты в отеле, пароль от Wi-Fi). Не закрепляйте заметку только потому, что она важна: подготовка к встрече привязана к своему дню, материалы проекта - к тегу, действия становятся задачами. Закрепляйте, только если пользователь просит или заметка явно подходит под такой post-it.

Восстанавливает заметку обратно в QuickNote в папке Inbox (разархивирует) или восстанавливает удалённую заметку из корзины.

Ищет по всем данным Keepsake — контактам, записям, задачам, заметкам и компаниям. Поиск не учитывает диакритические знаки (например, 'berenice' находит 'Bérénice').

Ищет компании по названию, email, веб-сайту или адресу. Поиск не различает диакритические знаки.

Ищет контакты по имени, email, компании и т.д. Поиск не различает ударения.

Переносит задачу на новую дату.

Останавливает повторяющийся блок с указанной даты и далее (в приложении - "Stop repeating"). Прошедшие дни сохраняют свои блоки, а привычка сохраняет свою историю; будущие вхождения, уже созданные и ещё не отмеченные, удаляются. Чтобы пропустить один день и сохранить повторение, используйте delete_day_block для блока этого дня.

Снова помечает выполненную задачу как ожидающую.

Удаляет связь между контактом и компанией. Ни контакт, ни компания при этом не удаляются.

Удаляет связь между компанией и записью.

Удаляет связь между контактом и записью.

Удаляет связь между компанией и заметкой.

Удаляет связь между контактом и заметкой.

Удаляет заметку из календарного дня (заметка сохраняется нетронутой). Чтобы ПЕРЕНЕСТИ заметку на другой день, лучше используйте update_note с новым массивом dates: один вызов вместо двух. Идемпотентно.

Удаляет ручную связь между двумя заметками (обе заметки остаются). Ссылки, полученные из встроенной разметки label Markdown в содержимом заметки, сохраняются: отредактируйте содержимое, чтобы удалить их.

Удаляет связь между сущностью и тегом.

Удаляет связь между компанией и задачей.

Удаляет связь между контактом и задачей.

Удаляет связь между заметкой и задачей. И задача, и заметка сохраняются.

Обновите существующую компанию. Отправляйте только те поля, которые хотите изменить.

Обновите существующий контакт. Отправляйте только те поля, которые хотите изменить.

Создаёт или обновляет намерение дня или вопрос дня (upsert по дате). Поле note - это намерение или вопрос дня: одна короткая строка в верхней части Today view (мантра, намерение, единственный приоритет или вопрос, который стоит держать в голове). Не журнал: никогда не пишите здесь итоги дня. Намерение действует только на свой день: оно не переносится на следующие дни. Пользователь вводит его вручную каждое утро, намеренно - не устанавливайте его за него, если он не попросит. null или пустая строка удаляет его. НЕ для прикрепления заметки к дню: это поле состоит из одной строки, и вы перезапишете намерение пользователя. Чтобы поставить заметку на день, используйте create_note с dates или link_note_date.

Обновляет блок времени (title, duration, anchor, note, done). Отправляйте только те поля, которые хотите изменить. Блок сохраняет своё место в порядке таймлайна. Отметка блока как выполненного фиксирует, когда он произошёл на самом деле: он заканчивается сейчас и начинается на запланированную длительность раньше (но не раньше, чем закончился предыдущий выполненный блок). В приложении выполненный блок остаётся на этом времени в прошлом дня, а оставшиеся дела выстраиваются от текущего времени. Блок с фиксированным временем сохраняет свой час.

Обновите существующую запись. Отправляйте только те поля, которые хотите изменить.

Обновляет существующую QuickNote или Note. dates ЗАМЕНЯЕТ полный набор дней, с которыми связана заметка: способ перенести заметку на другой день ("не сделано, перенеси на завтра"). Чтобы добавить или удалить один день, не трогая остальные, лучше использовать link_note_date / unlink_note_date. status продвигает заметку по потоку публикации ("это готово"); установка стадии для Inbox QuickNote также оставляет её как Note.

Редактирует содержимое маргиналии. Промежуточного состояния нет: маргиналия либо существует, либо удалена. Замечание, которое должно пережить пересмотр заметки, вместо этого становится заметкой или связанной задачей.

Изменяет повторяющийся блок НАЧИНАЯ С ДАТЫ И ДАЛЕЕ (название, длительность, фиксированное время, дни недели). Прошлое никогда не перезаписывается: предыдущие дни сохраняют свои блоки как были, и привычка сохраняет свою историю. Предстоящие повторения, уже созданные и ещё не отмеченные, обновляются или удаляются, если их день больше не запланирован. Чтобы изменить только один день, используйте вместо этого update_day_block для блока этого дня.

Обновляет существующий тег. Отправляйте только те поля, которые хотите изменить. Поддерживает name, description, color, icon, статус избранного и порядок задач и разделов страницы (tasks_order).

Обновляет существующую задачу. Отправляйте только те поля, которые хотите изменить.

Обновляет заголовок задачи. Отправляйте только те поля, которые хотите изменить.