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]] для автоматической привязки тегов.

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

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

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

Создаёт новый заголовок задачи (разделитель секции). Добавляет его в items_order тега для позиционирования.

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

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

Удаляет временной блок. Его ref удаляется из timeline_order дня; для task bucket сами задачи не затрагиваются (они возвращаются к вычисленному bucket дня).

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

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

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

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

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

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

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

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

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

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

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

Получает сводку журнала за конкретный день по дате.

Получает одну заметку по ID, включая её теги, связанные контакты, связанные задачи и связанные заметки. Используется, когда пользователь указывает вам на одну конкретную заметку (например, даёт её 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 = задачи вне любого раздела).

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

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

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

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

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

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

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

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

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

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

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

Перечисляет временные блоки дневной временной шкалы (вид Day view) в порядке временной шкалы. Блок - это либо активность (тип 'block'), либо task bucket (тип 'tasks', группирует задачи дня без привязки ко времени). Meta содержит необработанный порядок временной шкалы дня: ссылки 'b:<uuid>' - это блоки, простые uuid - это задачи внутри выполнения bucket.

Выводит ежедневные сводки журнала. Фильтрует по диапазону дат.

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

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

Выводит список заметок. QuickNotes (inbox, ещё не архивированные) и Notes (архивированные, постоянные). Фильтрует по статусу pinned или archived.

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

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

Выводит список задач. Фильтрует по статусу (ожидает/завершено), date_type или конкретной дате.

Закрепите QuickNote или заметку, чтобы она отображалась вверху папки «Входящие».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создаёт или обновляет ежедневную сводку дневника. Если запись за эту дату уже существует, она будет обновлена (upsert).

Обновляет временной блок (название, длительность, якорь, заметку, выполнено). Отправляйте только те поля, которые хотите изменить. Блок сохраняет своё положение в порядке временной шкалы.

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

Обновляет существующую QuickNote или Note.

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

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

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

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