Skip to main content
Glama
jpwilliams
by jpwilliams

Notes — un cuaderno en el que escribe tu IA

Un cuaderno de viñetas diario para Notes — como plugin de Claude Code, como Agent Skill independiente para cualquier otro cliente, y como una URL MCP simple para cualquier cosa que lea una.

Tu IA guarda notas en tu cuaderno, por iniciativa propia: en la página de hoy, etiquetadas en el mismo grafo de entidades que todo lo que escribes, marcadas para que siempre puedas distinguir de quién es cada viñeta. Semanas después abres la página de un proyecto y tus notas y las suyas están en una misma página, en orden cronológico. Y la siguiente sesión las vuelve a leer, para que no tengas que volver a explicarlo.

No es una base de datos de memoria. No hay índice vectorial, ni política de expulsión, ni hooks, ni trae-tu-propio-Postgres. La memoria es una viñeta en un cuaderno que ya lees, corregible a mano, con un enlace de vuelta a la conversación que la produjo.

Instalación

Claude Code

/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skill

Cursor, VS Code, Codex, Gemini CLI, Antigravity, Amp, OpenCode, Warp…

La skill y la conexión están separadas aquí, porque estos clientes leen el formato abierto Agent Skills y aceptan una URL de servidor MCP propia.

gh skill install jpwilliams/notes-skill

Eso se instala en .agents/skills/, la ruta neutral de proveedor que comparten — así que es un solo comando sin importar cuál uses. (npx skills add jpwilliams/notes-skill hace lo mismo si prefieres no usar la CLI de GitHub.) Luego añade el servidor MCP:

https://notes.jpwilliams.dev/api/v1/mcp

Cualquier otra cosa

Cualquier cliente que hable MCP remoto puede usar esa URL directamente, sin paquete y sin instalar nada — descubre el resto por sí mismo. notes.jpwilliams.dev/install tiene las instrucciones por cliente.

Qué ocurre después, sea cual sea la ruta que hayas tomado

Se abre un navegador. Inicia sesión con la cuenta que ya tienes, lee lo que la conexión podrá hacer, y ponle un nombre — ese nombre es lo que aparece en cada viñeta que escribe, así que haz que sea lo que te gustaría leer en medio de las notas de un día. "Portátil de trabajo" gana a "Claude".

Eso es toda la configuración. No hay clave que emitir, ni clave que pegar, ni llavero, ni claude mcp add ni URL. Puedes desconectarla en cualquier momento desde la página 🔑 Acceso de máquina en notes.jpwilliams.dev, y deja de funcionar inmediatamente.

Related MCP server: GoLogX (logx-mcp)

En la aplicación de escritorio y el sitio web

La misma conexión, sin el plugin. Añade Notes como conector personalizado usando la URL https://notes.jpwilliams.dev/api/v1/mcp — la aplicación descubre el resto y te envía a la misma pantalla para aprobarla y nombrarla. El plugin merece la pena tenerlo en la terminal porque lleva una skill que enseña a Claude cuándo recurrir al cuaderno; el conector por sí solo lleva las herramientas y una versión más corta de la misma guía, enviada por el propio servidor.

Qué puede hacer

Cuatro herramientas, y una skill que enseña a un agente cuándo recurrir a ellas.

Tool

Qué hace

list_entities

El estante: cada proyecto, persona y tema, mencionados más recientemente primero.

get_entity

La página de una entidad — su descripción, menciones recientes con sus subviñetas, con qué co-ocurre, sus tareas pendientes.

get_day

La página de un día como markdown, más sus viñetas con ids.

append_note

Añadir viñetas a un día.

Qué no puede hacer deliberadamente

  • Solo añadir. Nunca puede editar ni eliminar nada — ni tu texto, ni el de otro agente, ni el suyo propio. Una corrección es una viñeta nueva, que es lo que hace un cuaderno de todos modos.

  • Solo entidades existentes. Un #tag que nombre una entidad que no existe rechaza toda la llamada en lugar de descartarse silenciosamente. Renombrar y fusionar aún no existen, así que un error tipográfico sería un estante incorrecto permanente en un índice que realmente lees. Creas la entidad de un proyecto una vez, a mano.

  • Sin búsqueda en el corpus. Cada lectura está limitada por la forma, no por un tope, lo que hace que leer un proyecto cueste lo mismo con una década de notas que con un mes.

Qué lee

Todo tu cuaderno — cada día, cada entidad, cada tarea pendiente, incluidas las notas extraídas de transcripciones de reuniones. Eso es lo que estás aprobando en la pantalla de consentimiento, y lo dice con esas palabras.

Añadir y leer es todo lo que obtiene, aplicado en el servidor en el punto en que se leen los datos, no como una línea en una descripción de herramienta que un modelo puede o no respetar.

Qué ves

Cada viñeta que escribe un agente es visible en tu vista de día y está marcada con el nombre que le diste a esa conexión. Pasa el cursor para ver la credencial, el momento en que se escribió y lo que el agente dijo sobre sí mismo — su proveedor, su modelo, la conversación de la que proviene. Esos últimos son autoinformados y etiquetados como tales; el nombre y la marca de tiempo son nuestros, que es la razón por la que le pones nombre en lugar de que la aplicación se nombre a sí misma.

La marca registra el origen y nunca se borra. Editar a mano la viñeta de un agente no la convierte en tuya — ordenar una es el caso normal, y una marca que desapareciera al primer toque se habría ido de la mayoría de ellas en una semana. Eliminar la viñeta es el gesto de corrección.

Si prefieres leer tu día sin ellas, 🔑 Acceso de máquina tiene un interruptor. Las ejecuciones ocultas dejan un recuento donde estaban, para que un día nunca finja en silencio que no se escribió nada. La misma página lista cada conexión y desconecta una al instante — las notas que ya escribió permanecen exactamente donde están, aún marcadas con el nombre que le diste.

Requisitos

Una cuenta de Notes. La aplicación está en notes.jpwilliams.dev.

Licencia

MIT.

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    C
    maintenance
    MCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.
    0
    1
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    Tamper-evident audit logging for AI agents. Append-only, hash-chained, optionally Ed25519-signed log. The MCP server lets an agent keep and verify a record of what it actually did.
    5
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    A local MCP server for journaling, organizing, and recalling your work. It captures entries as plain markdown files, indexes them for full-text and structured search, and enables querying via natural language.
    1
    MIT
  • A
    license
    -
    quality
    A
    maintenance
    An MCP server that lets AI agents read and write a self-hosted TriliumNext knowledge base over its ETAPI, enabling note capture, structured table maintenance, and search.
    4
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jpwilliams/notes-skill'

If you have feedback or need assistance with the MCP directory API, please join our Discord server