leaf-books

Name: leaf-books
Author: kaayru

Leaf — Reading Tracker Connect your Leaf reading library to any AI assistant.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

Get Status: Call this at the very start of every conversation before any other tool. Returns current streak, milestone, active books, today's progress, and whether streak recovery is possible. If the
List Books: List the user's books with full details, optionally filtered by reading status. Use get_status for greetings and reading context; use this when you need the full book catalogue (all status
Search Books: Search for books by title, author, or ISBN to retrieve metadata (cover, ISBN, page count, language, year) before adding to the library

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Leaf — Reading Tracker

Connect your Leaf reading library to any AI assistant. Track books, log reading sessions, manage your backlog, and stay on top of your reading streak — all through natural conversation.

What you can do

Check your reading status — current streak, today's progress, active books, and milestone tracking
Log reading sessions — record pages read for any book in your library
Manage your library — add books, change their status (reading, finished, dropped, backlog), or remove them
Set reading goals — pages per day or a target finish date, with projected completion dates
Search books — look up books by title or ISBN with cover art and metadata

Requirements

A Leaf account with an active Leaf Pro subscription
Authentication via OAuth — you'll be prompted to sign in with your Leaf account on first use

Authentication

This server uses OAuth 2.0 with PKCE. Your MCP client will open a browser window to sign in — no manual token setup required.

Как подключить

Как подключить leaf-books к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://leaf-books--kaayru.run.tools

Откройте Claude (сайт claude.ai или приложение для компьютера).
Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
Нажмите Добавить пользовательский коннектор (Add custom connector).
Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить leaf-books к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://leaf-books--kaayru.run.tools

Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
Откройте Настройки → Коннекторы и нажмите Создать (Create).
Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить leaf-books к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://leaf-books--kaayru.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (9)

Технические названия из tools/list. Нужны только разработчикам.

get_status	Call this at the very start of every conversation before any other tool. Returns current streak, milestone, active books, today's progress, and whether streak recovery is possible. If the response includes streak.recoverable_missed_date, ask the user if they want to log reading for that date to recover their streak.
list_books	List the user's books with full details, optionally filtered by reading status. Use get_status for greetings and reading context; use this when you need the full book catalogue (all statuses, details).
search_books	Search for books by title, author, or ISBN to retrieve metadata (cover, ISBN, page count, language, year) before adding to the library
add_book	Add a new book to the user's reading list. Always call search_books first before calling this tool to retrieve accurate metadata (cover, ISBN, page count). Never call this tool without a prior search_books call for the same title.
log_reading_progress	Log reading progress for a book. Provide either book_id (preferred) or book_title for fuzzy lookup. Use is_yesterday: true only when the user explicitly confirms they want to backdate to yesterday to recover a missed streak day.
set_book_status	Change the reading status of a book. Provide either book_id (preferred) or book_title for fuzzy lookup.
delete_book	Remove a book from the user's library. Provide either book_id (preferred) or book_title for fuzzy lookup. Always call without confirmed first — the tool returns the matched book so you can ask the user to confirm. Once the user confirms, call again with confirmed: true and book_id to complete the deletion.
set_reading_goal	Set or update the reading goal for a book. Provide either book_id (preferred) or book_title for fuzzy lookup. Returns the updated book with a projected finish date (pagesPerDay goal) or required daily target (days goal).
get_reading_stats	Returns lifetime reading statistics: streak history, all unlocked milestones, library counts by status, and total pages read across all books. Use when the user asks about their overall reading progress, stats, or achievements — not for today's live status (use get_status for that).