feedly-mcp

Lee tus suscripciones de Feedly desde Claude. Pregunta "¿qué hay de nuevo en mis fuentes de IA?" y obtén una respuesta, sin abrir un navegador.

⚠️ Nada de esto es instalable todavía

Este repositorio contiene actualmente solo documentos de diseño — ningún código.

No hay paquete npm, ni bundle .mcpb, ni releases. Todos los comandos que aparecen abajo fallarán hoy. Describen la experiencia prevista, escritos primero para que el flujo de instalación pudiera diseñarse antes de construirse.

Vigila el repositorio si quieres saber cuándo cambie eso.

Qué hace

Seis herramientas que permiten a un agente leer tu cuenta de Feedly:

Qué no hace

Esto es un conector, no una aplicación de lectura. Traduce una solicitud en una llamada a la API de Feedly y devuelve una respuesta limpia. No guarda tus artículos, no crea un archivo buscable, no clasifica las cosas con el tiempo ni te envía resúmenes.

Todo eso son cosas buenas de querer — hazlas encima de esto, en un Claude Project, una skill o una tarea programada. Mantenerlas fuera es lo que hace que esto sea lo bastante pequeño para confiar.

Privacidad

Todo se ejecuta en tu propia máquina.

• Tu token de Feedly permanece local. Nunca se envía a ningún sitio excepto a api.feedly.com.

• Sin cuenta con nosotros, sin servidor en el medio, sin telemetría.

• Nada de lo que lees se almacena más allá de una caché local de corta duración.

Requisitos

• Node.js 20 o superior — compruébalo con node --version

• Una cuenta de Feedly y un token de API (paso 1 abajo)

• Claude Desktop, Claude Code o cualquier otro cliente MCP

Paso 1 — Obtén un token de API de Feedly

1. Inicia sesión en Feedly en tu navegador.

2. Visita https://feedly.com/v3/auth/dev.

3. Sigue las instrucciones de allí para generar un token de acceso de desarrollador.

4. Copia el token en un lugar seguro para el siguiente paso. Es una contraseña — trátalo como una.

Dos cosas que debes saber antes de continuar.

Los tokens caducan. En una cuenta gratuita, un token de desarrollador es válido durante unos 30 días, transcurridos los cuales repites este paso. Los planes de pago pueden renovarlo automáticamente. Es política de Feedly, no es algo que esta herramienta pueda evitar.

La disponibilidad de tokens depende de tu plan. El hecho de que la propia documentación de Feedly sea inconsistente sobre qué niveles de cuenta pueden autoemits tokens de API. Si la página anterior no te da un token, este conector no puede funcionar con tu cuenta, y no hay solución cabe más allá de contactar con Feedly.

Paso 2 — Instalar

Aún no disponible. Las tres vías que aparecen debajo dependen de un artefacto publicado — un paquete npm o un bundle .mcpb — y no ninguno no existe. Esta sección es el plan, no instrucciones que puedes seguir hoy.

Elige una de las tres vías siguientes.

Opción A — Claude Desktop, en un clic (la más fácil)

1. Descarga el último feedly-mcp.mcpb desde la página Releases del repositorio. (Aún no hay releases publicados.)

2. Abre Claude Desktop → Ajustes → Extensiones.

3. Arrastra el archivo .mcpb a la ventana.

4. Aparece un formulario de ajustes. Pega tu token en Token API de Feedly y haz clic en instalar.

Tu token va a llavero de tu sistema operativo, no a un archivo de texto plano. Todo en Configuración se puede editar desde este mismo formulario.

Opción B — Claude Desktop, configuración manual

1. Abre tu archivo de configuración de Claude Desktop:

   SO	Ruta
   macOS	~/Library/Application Support/Claude/claude_desktop_config.json
   Windows	%APPDATA%\Claude\claude_desktop_config.json

   Si el archivo no existe, cría con {} como contenido.

2. Añade entry feedly:

   GXPP1

   ¿Ya tienes ortes others servers bajo en mcpServers? Añade feedly junto a ellos — no reemplaces el bloque.

3. Reinicia Claude Desktop por ett. Cerrar la venta una esuficte; sal de la app.

4. Busca el icono de herramientas en el cuadro de mensaje. feedly deberí aparece llistado.

Opción C — Claude Code

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

Verificaur que se regstró:

claude mcp list

Ejecuta claude mcp add --help si su versión um espera un flag distinto para las varibles de entorno.

Paso 3 — Comprueba que funciona

Antes has iniciar pregunta a Claude, confirma la conexión desde túa terminal:

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

Un resultado sano tiene este aspeto:

✓ 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 nunca imprime tu token. Usa la lista de carpetas que se da cuando scope en el paso 4.

Si algo falla, salta al Troubleshooting.

Paso 4 — Configurar (opcional)

La config por definición is razonable y puedes omitir esta por completo. El único ajuste que mere la pena revisar tempran es scope — qua carpetas tien Claude permiso para ves el at .

Crea ~/.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

Dos razones para establecer include_folders:

• Privaciodad. Tu carpet a de abdominal no necesita pár ser legible por agent e.

• Enfoque. Menos carpetas signifca respuest la más cortas y menos conteto gast do en mterial que no has pregunt do.

Ya has entado por vía de O pción A, edíta estos en el formulario de ajuest as de extensión — mis opciónes, sin res archivo que enc accidente.

Lista completa del ajustes: docs/configuration.md

Uso

Solo y pregunta. Algunas cosa en que funcionon bien:

• "¿Qué ab de entry ?"

• "¿Algo que valga le penar en AI - Research esta semana?"

• "¿Cuántos articúlos no leííod me tengo, desglósados por carpet?"

• "Encots me feeds sobre inferecencia local de LLM"

• "Resume el top 5 por engagement de last 8 horas"

No necesita saber nos IDs de tre. Nomb de tre carpetas funcionan, y Claude pue icono de listarlas.

Referencia completa de las herramientas: docs/tools.md

Tu cuota de API — por favor lee esto

Tu cuota de API dria és —** — más pequeña que lo que sugiére documentación de Feedly.

Medido contr the la API en vivo, to token de de dev in a paid Pro Plus sequence el report tou de 50 calls yada di, reset al reded medianoche UTC. The propio docs de Feedly describes 250 on free y 500 Pro. Plan for 50.

That is about ocho conversaciones al día si el agent is parlanchín, and the cuota es comand included no el Feedly in tu browser, which se dejen de funcar si undo agphone extinction it.

So that tool su defense the presupuesto:

• El **{{{

• Fold sublists are caches** for 24 hours.

• Repeated disjoint requests within 15 minutes have been served from cache.

• One call получает entera folder — Never a por feed.

• Hard ceiling 10 * session and 40 / day —** leaving "full headroom".

• Every response "harm" how how quota** — below 10, warning.

Check your own ceiling`s limit** reports — if >50, raise budget in configuration.

— Sint en bajo embargo no fue.

Marcado de articúlos cómo leído

**mark_read * es permanente. Feedly no tiene un undesacer, y recover = "emailing them." So la ships disabled.

Para enable mark_single:

GXP7

Para also allow en folder completed read in one — blaster — radius la second:

GXP8

Unsub nope — intentionally.

***permanente no puedo.

Solución errores

doctor says missing token

Look at the order: FEEDLY_TOKEN variable, then file feedly.token_file. Confirm which you usuario — often modifies conflict with "environment wins".

"Token expired" / 401

28 days: repeat step 1 and update token. It's normal than not.

Claude does not see

Quit completely — /mcp reload. Check JSON validity (commb cauda typical) and node --version >= 20.

"Rate limit excedeed" (429)

Daily charged on Feedly's schedule. Message has reset. Server won't retry.

"Daily budget exhausted"

It this tool's limit, not Feedly's and you have real quota. Bu looking for budget. Set budget daily_calls.

"outside configured scope"

scope.include_folders has set, no folder the folder. Add or clear.

Cache from other

Clear cache / retry:

validation

Contributing

Compatidores y PRs antis. Rationale design — including exclusions — is feedlymccspec.md. Do it before prop. If in "no scope", decide not overlook, but you canindeed argue.

##Licence

MIT

feedly-mcp

Lee tus suscripciones de Feedly desde Claude. Pregunta "¿qué hay de nuevo en mis fuentes de IA?" y obtén una respuesta sin abrir un navegador.

⚠️ Nada de esto es instalable todavía

Este repositorio contiene actualmente solo documentos de diseño — ningún código.

No hay paquete npm, ni bundle .mcpb, ni releases. Todos los comandos que aparecen abajo fallarán hoy. Solo se describe la experiencia prevista, tal como se espera que sea. Te invitamos a señalar si quieres saber cuándo cambie eso.

Qué hace

Seis herramientas que permiten a un agente leer tu cuenta de Feedly:

Qué no hace

Es un conector, no una aplicación lectora. Trace de una solicitud en una llamada a la API de Feedly y devuelve una respuesta clara. No guarda tus artículos, no crea un archivo normale, no clasifica objetos y con mantenimiento, no te envía envíos.

Son tan buenas cosas que puedes desear — constrúyelas encima de esto, en un Claude Project, un funciona, una programada. Mantenerlas fuera with hace que este lugar sea lo suficientemente pequeño para confiar.

Privacidad

Todo se ejecuta en tu propia máquina.

• Tu token de Feedly permanece local. Nunca sea envía a ningún lugar excepto a api.feed.

• No hay cuentas con nuestro, no hay servidor intermedio, no hay telemetría.

• Nada de lo que se lee se necesita todo más allá de una caché local de corta duración.

Requisitos

Tienes Node.js 20 o posterior — compruébalo con node --version

• Unacenta de Feedly y una API clave (paso 1 abajo)

• Claude Desktop, Claude Code o cualquier otro cliente MCP

Paso 1 — Obtén una API token de Feedly

1. Inicia sesión en Feedly en tu navegador.

2. Ve a https://feedly.com/v3/auth/dev .

3. Sigue las instrucciones que aparecen ahí para generar un token de acceso para desarrollador.

4. Cópialo en un lugar seguro durante el tiempo que toque. Es una contraseña -> eso hip.

Dos advertencias antes de seguir.

Los tokens caducan. En una cuenta gratuita un token de desarrollo es válido ~30 días, luego se repite este paso. Los planes de pago pueden renovarse automáticamente. Es de Feedly, no es algo que esta herramienta pueda evitar.

La disponibilidad del token depende de tu plan. La documentación tuya de Feedly es inconsistente sobre qué tier acumulan una API clave. Si la página que no te da token, el social no puedes trabajar con tu cuenta no hay workaround salvo llamar a Feedly.

Paso 2 — Instalación

Aún no disponible. Todos los siguientes (npm package ó MCP bundle) no existen. Esta parte es plan — no no por.

Selecciona una de las siguientes opciones.

Opción A — Claude Desktop, con un clic (más fácil)

1. Descarga el un último feedly-mcp.mcpb de la página Releases del repo. (Ninguno aún publicado).

2. Abrir Claude Desktop → Ajustes → Extensiones.

3. Arrastra el archivo .mcpb a la ventana.

4. Ver un formulario; pega tu token en Feedly API token y pulsa instalar.

Tu token se guarda en el llavero, no en ISO en un archivo plano. Todo en (Configuración](docs/configuration.md) edita desde el mismo formulario.

Opción B — Claude Desktop, manual config

1. Abierto la configuración de Claude Desktop:

   | SO | Ruta | | ------- | ------- | | macOS | igual que ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json |

   Si no existe, crea con {}.

2. Añadir entrada feedly:

   ```
   

3. Reinicia Claude Desktop enteramente — cerrar no es suficiente. Salir de la app.

4. Busca icon de herramientas. feedly debe listarse.

OpciónC — Claude Code

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

Verifica que registró:

↓GXP3

Como tal haz claude mcp add --help si tu distinta espera una variable.

Paso 3 — Verifica lo de

Do Se confirma con terminal:

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

Estado rear, ejemplo:

✓ 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 nunca imprime tu token. Uso arrays de carpeta de folder en paso 4.

Paso 4 — Configuración (opcional)

Omitible. La única pieza en que vale mirar ** es scope — qué carpetas Claude pueda .

Ruta ~/.config/feedly-mcp/config.toml:

GXP6|

Dos razones para include_folders:

• Privacidad. no facturar el an entero cuota.

• Enfoque. Menores, respuestas en esencial.

  pción A; esto se edita en ESTADO form mismo.

Config → Lista completa

Uso

Pide sin más. Así:

• "¿Qué nuevos hay en mis fuentes de IA de ayer?"

• "¿Algún artículo valíos en AI - Research esta se,ana?"

• "¿Cuántos tengo pendientes, po carpeta?"*

• "¿Encuentra fuentes sobre LLM local?"*

• "Resumo las top 5 por enganche"*

No necesita ID, nombre funciona. Léeme la lista:... (Referencia:) docs/tools.md.

División? șahor:

Tu cuota API — he, lee

** Tu API diaria ocurre — smaller that docs.

** un developer token → 50/day (Pro Plus). Fields 250 la docs dicen . Buena plan 50.

Cuidado: la cuota incluye el navegador si el agente está se va.

Herramienta tu (protege):

• Recargada + carpetas (cache 24 h)

• Request igual dentro 15' = sy cache

• Carpeta complete con 1 sola call, per fuente, never.

• TR, Lím at 10 session y 40 d.

• Respuesta con status reste. <10 observaciones.

Your own doct cumbr — the actually report. If >50, listo para ele in la [config](docs… #budget).

mark_non — apenas leer

mark_read es no deshacer — no es deshacer.

G7

Para adicional también marcar carpeta → second interruptor:

[writes]
enabled = true
bulk_mark_read = true

Desuscribir no existe. I dentro Feedly.

Problemas

doctor no da token

Vehicle orden: env FEEDLY_TOKEN y después file feedly.token_file. Confirmar donde est — confusion con Win.

Token expired / 401

Cuenta free 30 dias ***.

No vearme

Reiniciar completamente — no cae resta MCP. Sea JSON traling…

429

Día hasta — not auto re-int.

Agotado (daily)

Different: el ceiling de la herramient, no Feedly.

carpeta fuera

scope.include_folders . Include o clar, list.

Cache OK

Esto no falla. nor?

Borra cach:

rm -rf ~/.cache/feedly-mcp

Contribuir

Cities and PR. La fundament design — incluye explicito qué se excluye — pasar?

Contribución no. feedlymcpspec.md — si grep — read==. Lista "not in scope…" no inadvertidos, se tiene razón.

Licencia

MIT