Simple Sticky Notes for Codex

Integración local y no oficial que permite a Codex buscar, crear y organizar notas en Simple Sticky Notes 6.9.0.0 para Windows mediante MCP.

This is an unofficial community project. It is not affiliated with or endorsed by Simnet Limited.

Funciones

• Consultar libretas y buscar notas activas.

• Leer una nota por ID.

• Crear notas y libretas.

• Mover notas entre libretas.

• Marcar o desmarcar favoritas.

• Evitar duplicados al reintentar una creación con el mismo UUID.

• Mostrar Markdown habitual de Codex como texto enriquecido: negrita, cursiva, código breve, enlaces, viñetas, tareas y listas numeradas; conservar emojis.

• Reformatear una nota existente con una comprobación exacta del texto anterior.

• Crear y actualizar notas con formato RTF explícito: fuentes, tamaños, estilos, colores, resaltado, alineación e interlineado.

El conector no expone SQL libre ni elimina notas. format_note solo modifica la presentación y el texto visible de una nota cuando el contenido actual coincide exactamente con expected_text.

Related MCP server: MCP Apple Notes

Seguridad de las escrituras

Antes de modificar Notes.db, el servidor:

1. comprueba la versión de la aplicación y el esquema SQLite;

2. solicita un cierre normal de Simple Sticky Notes y aborta si no termina;

3. crea un respaldo con marca temporal;

4. aplica una sola transacción y ejecuta PRAGMA quick_check;

5. reabre la aplicación si estaba abierta.

Los respaldos se guardan en %LOCALAPPDATA%\Codex\simple-sticky-notes\backups.

Requisitos

• Windows 10 u 11.

• Simple Sticky Notes 6.9.0.0.

• Python 3.11 o posterior.

• Codex CLI o Codex desktop con soporte MCP local.

Instalación

git clone https://github.com/JFETA/simple-sticky-notes-codex.git
cd simple-sticky-notes-codex
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1

El instalador crea .venv, instala las dependencias, registra el servidor MCP y copia la skill a ~/.codex/skills. Después, inicia una tarea nueva en Codex.

Para una ubicación personalizada de la base o del ejecutable, define SSN_DB_PATH y SSN_EXE_PATH en el entorno del servidor MCP.

Uso

• Guarda este resumen en la libreta Trabajo y márcalo como favorito.

• Busca mis notas que mencionen presupuesto.

• Mueve las notas 12 y 14 a la libreta Ideas.

• Da formato a la nota 19 para que se vea como en Codex.

create_note interpreta Markdown de forma predeterminada. Para mostrar los caracteres Markdown literalmente, indica format="plain". Las listas numeradas conservan sus números; las viñetas y casillas se muestran con símbolos Unicode. Los enlaces muestran su etiqueta y URL visible para conservar la dirección. No se promete reproducir tablas ni bloques complejos de la interfaz de Codex.

Para formatos que Markdown no expresa, create_note acepta format="rich_json". Su text es JSON con paragraphs y runs. Cada run admite font (Segoe UI, Consolas, Arial, Times New Roman), size (6–72 puntos), bold, italic, underline, strike, color y highlight. Los colores disponibles son black, red, blue, green, yellow, cyan, magenta, white y orange. Cada párrafo admite align (left, center, right), spacing (1, 1.5 o 2) y prefix. Por ejemplo:

{"paragraphs":[{"align":"center","runs":[{"text":"Aviso importante","bold":true,"size":16,"color":"yellow"}]},{"prefix":"1. ","runs":[{"text":"Revisar hoy","underline":true,"highlight":"green"}]}]}

format_rich_note aplica esa presentación a una nota existente solo si el texto visible sigue siendo exactamente el esperado. Los prefijos de listas se muestran como texto, no como estructuras editables de lista nativa.

Las herramientas de escritura requieren aprobación en la configuración incluida del plugin.

Desarrollo

py -3 -m venv .venv
.\.venv\Scripts\python -m pip install -e ".[dev]"
.\.venv\Scripts\python -m ruff check src tests
.\.venv\Scripts\python -m unittest discover -s tests -v

Consulta CONTRIBUTING.md para proponer cambios y SECURITY.md para reportar vulnerabilidades.

Compatibilidad y riesgos

El formato SQLite pertenece a una aplicación de terceros y no constituye una API pública. Esta versión rechaza otros esquemas y versiones. Conserva respaldos y prueba las actualizaciones de Simple Sticky Notes antes de habilitar escrituras.

Licencia

Código distribuido bajo la licencia MIT. Simple Sticky Notes y sus marcas pertenecen a sus respectivos propietarios.