simplenote

The Simplenote MCP Server provides a memory-backed, MCP-compatible interface to your Simplenote notes, enabling Claude Desktop and other MCP clients to read, create, update, and delete notes as a backend. It includes enhanced note management capabilities such as fuzzy search, date-aware queries, and export options, making it a versatile memory/content source for Claude's memory and retrieval workflows. Core features include token-based authentication via environment variables, in-memory caching with background synchronization, and optional health/metrics endpoints for observability. Tools exposed by the server support common MCP operations and extended note operations, including bulk export and duplicate detection, to help you organize and retrieve notes efficiently.

Prerequisites:

• Python 3.10+ (recommended) or newer
• Git
• Access to the internet to install dependencies from PyPI

Installation steps:

1. Clone the repository or install from PyPI:

   • From source: git clone https://github.com/docdyhr/simplenote-mcp-server.git cd simplenote-mcp-server pip install -e .
   • Or from PyPI (if available): pip install simplenote-mcp-server

2. Prepare environment variables (recommended):

   • SIMPLENOTE_EMAIL=your.email@example.com
   • SIMPLENOTE_PASSWORD=your-password

3. Run the server (example):

   • python -m simplenote_mcp_server

4. Verify the server starts and is reachable at its configured port (default typically 8000 or as defined by the project).

Notes:

• If you prefer containerized deployment, see the Docker deployment section in the README for image usage and environment variable examples.

Environment variables:

• SIMPLENOTE_EMAIL and SIMPLENOTE_PASSWORD are required for authenticating with Simplenote when not using Docker images that bundle credentials.

Configuration tips:

• Use the MCP-compatible tooling (e.g., Claude Desktop) to connect to the server via the MCP protocol.
• If you enable health/metrics endpoints, consider securing them or restricting access in production.

Common issues:

• Ensure Python module name matches the entry point (simplenote_mcp_server) when using python -m.
• If using Docker or Smithery, follow the respective deployment guidance in the README to ensure environment variables are passed correctly.
• Verify that Simplenote credentials have sufficient permissions for the operations you intend to perform (read/write/delete).

Recommended practices:

• Regularly rotate credentials and update environment variable values accordingly.
• Monitor test coverage and CI results to ensure security and reliability after updates.