Simplenote Mcp Server
About
A server to connect and manage your Simplenote notes within Claude Desktop.
Details
- Author
- docdyhr
- GitHub stars
- 17
- Downloads
- 411
- Categories
- Productivity, Other, AI
Jump to
- Full note management: create, read, update, delete notes
- Advanced search with boolean operators, tags, and date filters
- In-memory caching with background synchronization
- Token-based authentication via environment variables
- Docker support with multi-stage builds and health monitoring
- Optional HTTP endpoints for health, readiness, and metrics
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Simplenote Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run via Docker (recommended), Smithery one-click install, or traditional Python install. Set the SIMPLENOTE_EMAIL and SIMPLENOTE_PASSWORD environment variables. Add the server to your Claude Desktop configuration with the command simplenote-mcp-server and the required credentials.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"simplenote mcp server": {
"simplenote": {
"description": "Access and manage your Simplenote notes",
"command": "simplenote-mcp-server",
"env": {
"SIMPLENOTE_EMAIL": "your.email@example.com",
"SIMPLENOTE_PASSWORD": "your-password"
}
}
}
}
}McpServers
{
"simplenote": {
"description": "Access and manage your Simplenote notes",
"command": "simplenote-mcp-server",
"env": {
"SIMPLENOTE_EMAIL": "your.email@example.com",
"SIMPLENOTE_PASSWORD": "your-password"
}
}
}Simplenote MCP Server
A lightweight MCP server that integrates Simplenote with Claude Desktop using the MCP Python SDK.
This allows Claude Desktop to interact with your Simplenote notes as a memory backend or content source.
<!-- Status & Build Badges -->
<!-- Project Info Badges -->
<!-- Download & Stats Badges -->
<!-- Development & Quality Badges -->
---
What's New (Unreleased)
26 Tools — Full Bear Parity + Simplenote Differentiators + Claude Companion Tools
Two new irreversible-deletion tools with mandatory safety guards:
- permanent_delete_note: Permanently destroy a single note; requires confirm=true; dry-run preview by default
- empty_trash: Permanently delete all trashed notes; defaults to dry_run=true (preview); requires dry_run=false AND confirm=true
- 1188 tests passing, 77% coverage, zero linting/type errors
v1.17.0
- search_notes async fix: Boolean AND queries no longer hang the server; search now runs in a thread-pool executor with a 30 s timeout
- Substring pre-filter: searching "test" now correctly returns notes containing "testing", "tested", etc.
- Real-engine integration test suite added; import error in test helpers fixed
v1.16.0
- publish_note: Publish a note to a public URL — unique to Simplenote MCP; returns public_url
- unpublish_note: Remove a note from public access; no-op if already unpublished
See the CHANGELOG for complete details.
See the CHANGELOG for complete details.
---
🔧 Features
- 📝 Full Note Management: Read, create, update, and delete Simplenote notes
- 🔍 Advanced Search: Boolean operators, phrase matching, tag and date filters
- ⚡ High Performance: In-memory caching with background synchronization
- 🔐 Secure Authentication: Token-based authentication via environment variables
- 🧩 MCP Compatible: Works with Claude Desktop and other MCP clients
- 🐳 Docker Ready: Full containerization with multi-stage builds and security hardening
- 📊 Monitoring: Optional HTTP endpoints for health, readiness, and metrics
- 🧪 Robust Testing: Comprehensive test suite with 1135+ tests and continuous integration
- 🔒 Security Hardened: Regular security scanning with Bandit, pip-audit, and dependency checks
---
🚀 Quick Start
Prerequisites
- Simplenote account (create one at simplenote.com)
- Python 3.10+ (for non-Docker installs) or Docker
Option 1: Docker (Recommended)
The fastest way to get started is using our pre-built Docker image:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
