Skip to main content
Glama
notes-mcp-server

notes-mcp-server

by harsh364

Tool server starter

CI

A minimal Model Context Protocol (MCP) tool server that exposes a tiny in-memory notes API. Use it to learn how agents discover tools, call them over stdio, and keep state between calls.

Tools exposed

Tool

Description

add_note

Create a note for a user id

list_notes

List notes for a user id

search_notes

Keyword search within a user's notes

Related MCP server: mcp-server-example

Run the server (stdio)

cd tool-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

notes-mcp-server

Wire the server into any MCP-compatible client using stdio transport (see your client’s MCP config docs).

Design

  • State: in-process dict (swap for SQLite/Postgres in your fork)

  • Scope: each note belongs to a user_id string — mirrors multi-tenant agent setups

  • Tests: store/unit tests + optional MCP stdio integration (RUN_MCP_INTEGRATION=1 pytest -m integration)

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage in-memory notes by listing, fetching, and creating notes through MCP tools over stdio.
      138 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to add, search, and delete persistent namespace-scoped notes through a local stdio server backed by a SQLite database. Namespaces isolate queries and content-derived IDs make repeated writes idempotent.
      MIT