SNotesSNotes Docs

Introduction

Welcome to the SNotes developer documentation for the Public REST API and Model Context Protocol (MCP) server.

SNotes is the privacy-first note-taking platform hosted and operated entirely in the European Union. Built as a secure alternative to Google Keep, SNotes gives you full ownership of your data with encrypted storage, zero tracking, and no vendor lock-in.

The SNotes developer platform enables you to integrate your notes into your own software, automation scripts, and AI workflows.

Core Capabilities

Public REST API

Full CRUD and lifecycle operations for notes, checklists, and collections via standard HTTPS JSON endpoints.

API Authentication

Generate personal API tokens in your account settings and authenticate external requests.

Model Context Protocol (MCP)

Connect AI assistants like Claude Desktop, Cursor, Zed, and custom agents directly to your note store.

MCP Tools Reference

Explore all 23 standardized MCP tools for listing, creating, searching, updating, and organizing notes.

Key Principles

  • EU Data Sovereignty: All API requests and persistent note data are hosted on servers within the European Union under strict GDPR compliance.
  • Fast & Lightweight: Predictable RESTful endpoints with indexed queries and compact payloads optimized for both humans and LLMs.
  • Dual Surface:
    • REST API: For scripts, CLI utilities, webhooks, and third-party integrations using Personal API Tokens (sn_live_...).
    • MCP Server: For autonomous AI agents using Streamable HTTP (JSON-RPC 2.0) and dedicated MCP OAuth credentials (sn_mcp_...).
  • Data Portability: Clean JSON representations and standard markdown formatting ensure your data is always accessible and easily exported.

On this page

Core CapabilitiesKey PrinciplesQuick Links