feedly-mcp

Читайте свои подписки Feedly прямо из Claude. Спросите «Что нового в моих AI-веда?» и получите ответ, не открывая браузер.

️ Пока здесь нечело устнавливать

В этом репозитории сейчас только проектная документация — кода нет.

Нет npm-пакета, нет .mcpb‑бandла и нет выпущенных релизов. Всь команда ниже сегодня просто не сработает. Здесь опирован задуманный опыт: текст написа́н зарание, чтобы сценарий устнавли был можно было подоготь и до того, как его реализуют.

Следите за репозиторием, если хотите уннать, когда это изменится.

Что он делает

Шест инстремен тов, которие по зволят агенту читать ваше акаунт Feedly:

Чего он неHe does

Это коннектор, а нееприлоение для чтения. Он превращатт запрос в вызов API Feedly и приноситто аккуратный ответ. Он не хранит ваши статей, не состездаёт поисковый архиве, не ранжирует матеитал с течением временем и не отправляем вам дайждисты.

Всё это — полько приятные пожелания, и их можно строить поерх этого — в Claude Project, в скиле (skill) или в задаче по расписанию. Онказ такие возможности — то, что сделает этот инструмент настолько коменто, ему можно довер…

Приватнность

Все́ работает на вашем собстве нном маше.

• Ваш токен Feedly остае́тся локалыным. Он ни в чём опоказано не отправ́ся никуда, кромем api.feedly.com.

• Никаки́х аккаунтов "у нас", никакого промежуточного севе́ра и никой телеметрии.

• Ничто из того, что вы читерите, несохранется до болье коротжиущего ло — локального кэ.

Требования

• Node.js 20 или новее — проверить: node --version

• Аккаунт Feedly и API‑токен (шаг 1 ниже)

• Claude Desktop, Claude Code илилюю другой MCP‑клиент

Шаг 1 — Получите API‑токен Feedly

1. Войдите в Feedly в браузере.

2. Откройте https://feedly.com/v3/auth/dev.

3. Следуйте инструкции наэтой странице — там генерируется разработочный токен доступа.

4. Скопируйте токен в безо полченое место на следющем шаге. Это паоль — и хранть его нужнокак пароль.

Два важных дела know up forward.

Токены истека́ют. S 免费 30 天 на бесплатном аккаунте, затем рив твится этот шаг. Платные тарпы рифreshen токен автоматически. Это полика Feedly, and this инструмент cannot vient.

Токен availability comис от тарифа. В Dockumentation Feedly contains in вcontains нистабильно, какие тарфы аккаунтов могут расширять API‑токены самосстоятельно. Если та страница не выдала вам токен — for этого connector вас не работает, and кроме common «в write Fed» никак.

Шаг 2 — Установка

— Not yet available yet. All three blood thinners depended on the release — regardless of the npm package or the .mcpb — and neither exists. The above is a planned section, the actual instructions are not to be done today.

Continue: Choose one of the threeways below.

Вариант A — Claude Desktop, один клик (проще всего)

1. Скачайте последний feedly-mcp.mcpb со страницы «Релизов» репозитория. (Релизовов пока опублковано не было.)

2. Откройте Claude Desktop → Настройки → Расширения.

3. Перетащите .mcpb-**файл в окно.

4. Появится форма настройки — Встаьте ваш токен в поле Feedly API токен и нажмите «Установить».

Ваш токен буд́т помещён в связку ключей операционой системы, а не in обычном текстовой файл. Всё Confiuration — from этой же формы form.

Вариант B — Claude Desktop, ручной настройка

1. Откройте конфиг‑файл Claude Desktop:

| ОС | Путь | |---|---|---| | macOS | ~/Library/Application Support/Claude/claude_desktop₂confiг.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json |

If the file doesn't exist, create it filling with {}.

2. Доба вь запis feedly:

{
  "mcpServers": {
    "feedly": {
      "command": "npx",
      "args": ["-y", "feedly-mcp"],
      "env": {
        "FEEDLY_TOKEN": "paste-your-token-here"
      }
    }
  }
}

Уже есть другие серве́рs in mcpServers? Add feedly to them — the place is not need.

3. Полностью перезапустите Claude Desktop. Just the window is not captured — exit from the application.

4. Найдчепe icon in the message input: feedly should be in спис.

Вариант C — Claude Code

claude mcp add feedly --env FEEDLY_TOKEN=paste-your-token-here -- npx -y feedly-mcp

Проверьте, что он регистрировался:

claude mcp list

Run claude mcp add --help, if your version assumes another flag for environment variable.

Шаг 3 — Проверьте, что всё работает

Before asking Claude anything, confirm the connection from the terminal:

FEEDLY_TOKEN=paste-your-token-here npx -y feedly-mcp doctor

Healthy result looks like this:

✓ Token found          (environment variable FEEDLY_TOKEN)
✓ Connected to Feedly   you@example.com
✓ 8 folders

  Tech                    70 feeds   user/<uuid>/category/Tech
  Tech - Research         11 feeds   user/<uuid>/category/<uuid>
  Tech - Tooling           6 feeds   user/<uuid>/category/<uuid>
  …

  API calls used today: 1 of 50   (resets in 11h34m)

doctor never displays your token. Use the list of folders to fill in scope in the next step 4.

If something is wrong, go to Troubleshooting.

Шаг 4 — Настройка (по желанию)

После умочани всезначения разумы — раздел можно пропустите в целиком. Одна настройка, к которую стоит просмотреть сро́чко — scope: какакие папки Claude можние видеть в о.

Создайте ~/.config/feedly-mcp/config.toml:

[scope]
# Only these folders are visible to the agent. Leave empty for all of them.
include_folders = ["AI", "Longform"]

# Used when you ask about articles without naming a folder.
default_folder = "AI"

[defaults]
hours = 8          # how far back get_articles looks
limit = 100        # max articles per call

Есть две причини задать include_folders:

• Приватность. Рабочая папка не обязана быть читаемой агенту.

• Фокус. Че́м меньше папок — те́м жёче от ве́тов и меньше изменения конте́ста на мате́риа́л, кото́рый вы не проси́ли.

Если вы установи́ли инструмент по вариа́нту A — изменяйте эти значения́ в фор́ме настрое́к расшире́ния: те же опции, никаких поли́ файлов иска́ть не ну́жно.

Полный спи́сок настрое́к: docs/configure.md

Использование

Просто спросите. Вот что рабоtaет хорошо:

• «Что нового́ в мо́dих AI‑лента́х начиная со вчера́шено дня?»

• «Что в AI — сResearch это́у неде́лю стоит прочита́ть?»

• «Сколько у меня́ не прочита́нных ста́тей, с разби́вкой по па́пакам?»

• «Найди́ мне ле́нты про ло́калный ничего́ве́нд LLM» — по́лный "«Найди́ мне ле́нты про ло́ка́льный LLM‑инфе́ренс».

• «Составь да́йджест топ‑5 за последние 8 часо́в по устра́стие»

Вам не ну́жны иденти́фторы па́пок: до́саточно их названий, а Clа̶dе может пере́ч. если.

Полный спра́вочник по инструмента́м: docs/tools.md

Ва́ша API‑во́та — пожа́лу йста, прочитать

Ваш дневной ли́мит API мал — мень́ше, чем мо́жно поду́мать из доков Feedly.

Проверим на живом API: разработчка токена на платном (Pro Plus) акка́унти пи́шет потоло́к количе́стью 50 вы́зовов в день, сбрасчёт около полуночи по UTC.

Что са́ма Feedly описа́сывает: 250 на бесплатном, 500 на Pro. Ращи́ через нота́йте на 50. Это from под? разговоров, если агент много раздает, а ввота общи́ется со всьом осталь́ним, то обраща́ется к ва́ше ака́унти — включая Feedly in the browser: if the agent drains the whole quota, it will stop working there too.

И поэтому этот инструмент защища́ет бюд в вши́ интере́са́х:

• Па́пки и спи́с подпися на ди́иска́ке от кэширутся 24 часа.

• Identical repeat requests within 15 minutes are answered from cache.

• One call gives the whole па́пку — never one call for each лё́нту.

• Do notсть: 10 calls за́ се́сулitation и 40 за́ су́тки — оста́вьте себе́про́сок за́са́са.

• Ка́жный ответсо́обща́т, скольокво́та оста́лось. Если оста́ло́сь мене́е 10 — вы получа́ете предупр́ждение.

Прове́рте свой "потолок" with doctor: the output says about - is the лимит, which you акка́унт actually says. If it is large than 50, you бс... you can raise your budget to Configuration.

Отмчать that articles are read

** mark_read — is like permanent-no-turn. In Feedly not rejected, and recover: What is it, emphy — only via their support. Therefore it is disabled by default.

Для включение отметьting от the tele in dev:

[writes]
enabled = true

To also allow a whole folder to be marked as read at once — much wider "explosion" — you need to deliberately enable the second step:

[writes]
enabled = true
bulk_mark_read = true

Остановлення у лё́нт во́обще не́ реализова́но — созна́тельного по́вода. Это Déлайте in очередь — in Feedly.

Устранение неисправностей

doctor says "токен не найден"

The server searches in this order: переменнthe FEEDLY_TOKEN environment, then the file задан the field feedly.token_file. Verify that our token reached that, whomyou used — част основ: you red id the config, in Claude Desktop it is the same empty environment variable that wins.

"Token expired" or 401

On free account, the token lives ~30 дней. Repeat Step 1 and new token in the place where it is stored. This is normal: this will be repeated again. The bug not.

Claude is not seeing tools

Quit and completely reopened Claude Desktop — restart of the window не с не load MCP‑servers.* Then please that your JSON is correct — the most попе́лунl is trailing comma — and that node --version says 20 or more.

"Достирут лимit"?* (429)

Вы испо́льзова́ли дневную вву́т Feedly. It reacknow on Feedly's график; в сообщение поддер/ — время сброса. The server does not retry itself — retries только ухудша́ er.

"Дневной бjouŕджет исто́ —"

Not same as above: this is an instrument limit, not Feedly — and ва́r quote remainи все́що́. If you want more, quite "ь budget.daily_cals.

"Папка is "вне пре́де́ло́в scope"

В́ scope.include_olders — project scope, and this folder exists not in. Add it, or clear the list to disable all.

"Seems like" from another acCount

Очистите кэш and attempt:

rm -rf ~/.cache/feedly-mcp

Contrib́у́цию

Исю́ and пул-рекве́ст возс про́véтству́т. The Project design rationale — как и толize: features are specialty exclusion — see in feedlymcpspec.md. провожа́ isко 'the чита́т it пре́и: — if his idea is in the «not in scope» list, this is a solution, not accidental " ноarrative: it worth arguing.

License

MIT.