notes-lite
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@notes-lite Save a note titled Grocery List with milk, eggs, and bread"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server Starter Lite
A minimal, tested Model Context Protocol server in Python. It's built on the official MCP Python SDK v2 and is small enough to read in two minutes. It is one stdio server with two typed tools over an in-memory notes list, plus tests that call it in-process and as a real subprocess.
src/mcp_server_lite/server.py the server: add_note, search_notes
tests/test_server.py in-process tests through the SDK's Client (fast)
tests/test_stdio.py launches the server as a subprocess, like a host doesQuick start
Requires uv and Python 3.10+.
git clone https://github.com/team-humaki/mcp-server-starter-lite
cd mcp-server-starter-lite
uv run pytest # 5 passed
uv run mcp-server-lite # starts on stdio and waits silently: that is correct (Ctrl+C to stop)Use it from Claude Code
claude mcp add notes-lite -- uv --directory /ABSOLUTE/PATH/TO/mcp-server-starter-lite run mcp-server-lite
claude mcp list # notes-lite: ... ✔ ConnectedThen ask Claude to "save a note titled X". The tools appear as mcp__notes-lite__add_note and mcp__notes-lite__search_notes.
Other hosts
Any MCP host that launches stdio servers can use the same command and args: uv --directory /ABSOLUTE/PATH/TO/mcp-server-starter-lite run mcp-server-lite. (Only Claude Code was tested; see below.)
Related MCP server: Notes MCP
What it shows
Typed inputs.
Annotated[..., Field(min_length=..., le=...)]becomes the JSON Schema the model sees, and bad input comes back as a tool error instead of a crash.Structured output. Return a Pydantic model or a list of them and the client gets both text and
structured_content.Model-facing errors.
ToolError("...")reaches the model asis_error: true, so write it as an instruction.stdio hygiene. Log to stderr and never
print(), because stdout is the protocol wire.Testing without a host.
async with Client(mcp) as client:runs the real protocol in-process.
Make it yours
Rename the server (
MCPServer("notes-lite")) and the package.Replace
NOTESwith your database or API client.Replace the two tools. Keep the docstrings specific, because they're what the model reads to decide when to call a tool.
Update the tests, then
uv run pytest.
Tested
uv run pytest: 5 passed on Python 3.13 and 3.10, withmcp2.3.0 (pinned inuv.lock).Claude Code 2.1.310 (Linux):
claude mcp add(the command above) andclaude mcp listshowed it as✔ Connected. A session calledadd_noteand got{"id":1,"title":"Hello from Claude Code","body":""}back. The model side was a scripted local API, not a real model.Not tested: Cursor, Claude Desktop, VS Code, macOS, Windows.
What the full version adds
Python MCP Server Starter (paid, $12) adds:
A full "notes" server showing every building block: resources and URI templates, prompts, a Pydantic model as tool input, tool annotations (read-only/destructive),
Context, and error handling for each type.Streamable HTTP with OAuth 2.1 bearer auth as a resource server. It covers Protected Resource Metadata, 401/403 challenges, per-tool scopes, a JWT/JWKS verifier and DNS-rebinding protection, with a dev-key script for local testing.
A Dockerfile, and config snippets for Claude Code, Cursor, Claude Desktop and VS Code.
32 tests: in-process, stdio subprocess, a real uvicorn HTTP server with auth, and the JWT verifier. Plus documented SDK and spec gaps and an upgrade guide.
License
MIT. See LICENSE.
Available Tools
2 toolsadd_noteB
Save a note and return it with its id.
Inputs: title (required), body. Returns: id, body, title
search_notesA
Find notes whose title or body contains the query.
Inputs: query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools serve clearly distinct purposes: one writes a note, the other queries existing notes. There is no overlap or risk of misselection.
Both names follow a consistent verb_noun snake_case pattern (add_note, search_notes). The convention is predictable and readable.
Two tools is thin for a notes server; creation and search alone leave little room for a full workflow. The count itself is not excessive, but it feels under-scoped.
The surface covers only create and search; there is no way to fetch a note by id, list all notes, update content, or delete a note. These significant gaps will block common agent tasks like editing or cleanup.
Maintenance
Related MCP Connectors
Search, read, write, and organize your Scratchpad notes from any MCP client.
Save and search your LostInNotes notes by meaning from any MCP client. OAuth sign-in or token.
Read and write your Caliu notes from any MCP client: search, create, tag, remind, attach files.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides MCP tools to create and retrieve notes stored in memory.-
- FlicenseAqualityDmaintenanceProvides an in-memory notebook interface with tools to create, retrieve, list, update, and delete notes, designed to test agent behavior through realistic MCP tool interactions.51-
- AlicenseNot gradedqualityDmaintenanceEnables access to a notes knowledge base via MCP, providing tools for keyword search, note creation, and retrieval, along with browseable note resources.30 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables managing local Markdown notes by creating, viewing, listing, and searching notes and their contents through MCP tools.-