NoteMCP

NoteMCP

Guarda en dos segundos. Encuéntralo preguntando.

NoteMCP es una aplicación de toma de notas alojada con una superficie de primer nivel para el Model Context Protocol. Capturas notas escribiendo, por voz o mediante la hoja de compartir de tu teléfono. Tu asistente de IA busca, lee, escribe y etiqueta — como herramientas, no como un volcado de contexto pegado.

Este repositorio es la documentación pública de esa superficie de agente: las herramientas, el modelo de seguridad y dónde van tus datos. El código fuente de la aplicación no es abierto.

• Sitio web — https://notemcp.com
• Endpoint MCP — https://notemcp.com/mcp
• Transporte — HTTP Streamable
• Autenticación — OAuth 2.1, código de autorización + PKCE
• Versión del servidor — 0.5.0

El registro es gratuito, y todas las herramientas siguientes funcionan en el plan gratuito — lo que el plan gratuito limita es cuánto hacia atrás en tu colección puede leer el agente, no lo que puedes capturar.

---

Conectar

NoteMCP es un servidor remoto, así que no hay nada que instalar. Apunta tu cliente al endpoint y te guiará para iniciar sesión.

Claude

Añádelo como conector personalizado en Configuración → Conectores, usando la URL https://notemcp.com/mcp.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "notemcp": {
      "url": "https://notemcp.com/mcp"
    }
  }
}

VS Code

mcp.json — ten en cuenta que VS Code usa servers, no mcpServers:

{
  "servers": {
    "notemcp": {
      "type": "http",
      "url": "https://notemcp.com/mcp"
    }
  }
}

---

Las herramientas

Doce herramientas. Cinco de lectura, siete de escritura. Referencia completa en TOOLS.md.

Herramienta	Función	Solo lectura	Destructiva
search_notes	Buscar texto, etiquetas y metadatos de enlaces guardados	✅
list_recent_notes	El flujo, actividad más reciente primero	✅
get_note	Una nota completa, más su hilo	✅
list_tags	Todas las etiquetas, con recuentos de notas en vivo	✅
get_note_asset	Una imagen adjunta a una nota	✅
create_note	Escribir una nota nueva, o continuar un hilo
append_to_note	Añadir markdown al final de una nota
replace_in_note	Cambiar un tramo de texto		⚠️
update_note	Reemplazar campos completos		⚠️
tag_note	Añadir etiquetas
untag_note	Eliminar etiquetas		⚠️
delete_note	Mover a la papelera (recuperable)		⚠️

Dos reglas de diseño las moldean a todas:

Las listas nunca llevan cuerpos. Una foto capturada es una URL de datos de varios megabytes, y una de esas en una respuesta de lista reventaría la ventana de contexto de un agente. Las listas devuelven una etiqueta y una vista previa corta; get_note devuelve el cuerpo; una foto incrustada se redacta a ![photo] incluso allí, y los bytes provienen de get_note_asset solo cuando un agente realmente necesita mirar.

Editar es un parche. replace_in_note cambia un tramo en lugar de reenviar la nota. Cada escritura acepta un if_updated_at opcional, así que una nota editada en tu teléfono a mitad de redacción produce una escritura rechazada en lugar de una sobrescritura silenciosa.

---

Lo que el agente puede y no puede hacer

Consulta SECURITY.md para el modelo completo. En resumen:

• Alcanza solo tus notas, limitado por tu ID de usuario autenticado dentro de la propia base de datos — nunca por un parámetro que el agente suministre.
• No puede eliminar permanentemente. delete_note es un borrado suave; la aplicación puede recuperarlo.
• No puede acceder a internet abierto en tu nombre, con una excepción estrecha documentada en SECURITY.md.
• No puede reescribir el cuerpo de una nota que contenga una foto, porque MCP solo le mostró ![photo] — así que una reescritura destruiría lo que no pudo ver.

Dónde van tus datos, y qué terceros los tocan, está en DATA-FLOW.md. La política de privacidad vinculante es https://notemcp.com/privacy.

---

Ejemplos de prompts

Consulta examples/prompts.md.

---

Contenido del repositorio

Archivo	Qué es
TOOLS.md	Referencia completa de herramientas con anotaciones
SECURITY.md	Autenticación, aislamiento y radio de impacto
DATA-FLOW.md	Qué terceros ven qué
examples/prompts.md	Prompts que ejercitan cada herramienta
server.json	Manifiesto del Registro MCP
CHANGELOG.md	Cambios en la superficie del agente

Soporte

https://notemcp.com/support