Skip to main content
Glama

QuickMemo MCP Server πŸ“βš‘

Python 3.10+ MCP License: MIT Smithery Ready Tests

QuickMemo MCP is a sleek, minimalistic, and unique Model Context Protocol (MCP) server that provides AI assistants with a fast, structured scratchpad and context memo engine.

Built cleanly using the official Python MCP SDK, QuickMemo showcases all three core MCP primitivesβ€”Tools, Resources, and Promptsβ€”in an elegant, zero-bloat codebase.


🌟 Key Highlights

  • ⚑ Minimalist & Zero-Bloat: Under 150 lines of clean, readable Python code.

  • 🎯 All 3 MCP Primitives:

    • Tools: Save, list, search, filter, retrieve, and delete context memos.

    • Resources: Real-time markdown digest (memo://all) and dynamic telemetry (memo://stats).

    • Prompts: Ready-to-use prompt templates for note reviews and daily standup generation.

  • πŸ”’ Zero Configuration Required: Uses local persistent JSON storage (~/.quickmemo/memos.json or custom path).

  • πŸš€ Marketplace & Registry Ready: Preconfigured with smithery.yaml and Dockerfile for one-click deployment to Smithery and Glama.


Related MCP server: mindmap-mcp-server

πŸ“ Project Structure

quickmemo-mcp/
β”œβ”€β”€ docs/                               # Learning documentation & reports
β”‚   β”œβ”€β”€ EXISTING_MCP_EXPERIENCE.md      # Hands-on write-up evaluating Context7 & Playwright
β”‚   └── MCP_FUNDAMENTALS.md             # Complete MCP protocol & architecture guide
β”œβ”€β”€ src/
β”‚   └── quickmemo/                      # MCP Server package (<150 LOC)
β”‚       β”œβ”€β”€ __init__.py                 # Package exports
β”‚       β”œβ”€β”€ __main__.py                 # Executable entrypoint
β”‚       └── server.py                   # Core server (Tools, Resources, Prompts)
β”œβ”€β”€ tests/
β”‚   β”œβ”€β”€ demo_client.py                  # Live interactive demonstration script
β”‚   └── test_server.py                  # Pytest unit & integration test suite
β”œβ”€β”€ Dockerfile                          # Containerized deployment manifest
β”œβ”€β”€ LICENSE                             # MIT License
β”œβ”€β”€ pyproject.toml                      # Package configuration & dependencies
β”œβ”€β”€ README.md                           # Quickstart & user documentation
└── smithery.yaml                       # Smithery registry manifest

πŸ“ Architecture Overview

+-------------------------------------------------------------------------------+
|                                  MCP CLIENT                                   |
|             (Claude Desktop / Cursor IDE / Antigravity / Custom AI)           |
+-------------------------------------------------------------------------------+
                                       β–²
                                       β”‚ JSON-RPC 2.0 (stdio)
                                       β–Ό
+-------------------------------------------------------------------------------+
|                             QUICKMEMO MCP SERVER                              |
|                                                                               |
|   [TOOLS]                     [RESOURCES]                 [PROMPTS]           |
|   β€’ add_memo                  β€’ memo://all (Digest)       β€’ review_notes      |
|   β€’ list_memos                β€’ memo://stats (JSON)       β€’ daily_standup     |
|   β€’ search_memos                                                              |
|   β€’ get_memo / delete_memo                                                    |
+-------------------------------------------------------------------------------+
                                       β”‚
                                       β–Ό
                         Local JSON Storage Engine
                         (~/.quickmemo/memos.json)

πŸ› οΈ MCP Primitives Catalog

1. Tools (Model-Controlled Functions)

Tool Name

Parameters

Description

add_memo

title: str, content: str, category?: str, tags?: list[str]

Saves a new memo or snippet with optional category and tags.

list_memos

category?: str, tag?: str

Lists saved memos with optional category and tag filtering.

get_memo

memo_id: str

Retrieves full content and metadata for a specific memo.

search_memos

query: str

Performs keyword search across title, content, tags, and category.

delete_memo

memo_id: str

Deletes a memo by ID.

clear_memos

None

Empties the memo store.

2. Resources (Dynamic Context Streams)

Resource URI

MIME Type

Description

memo://all

text/markdown

Formatted dynamic markdown digest of all stored memos.

memo://stats

application/json

Real-time statistics (total memos, categories breakdown, tag distribution).

3. Prompts (Pre-Engineered Workflow Templates)

Prompt Name

Arguments

Description

review_notes

category?: str

Synthesizes saved memos into key takeaways and an actionable checklist.

daily_standup

None

Converts recent memos into a standard 3-part daily standup report.


πŸš€ Quickstart & Installation

Option 1: Local Setup with uv (Recommended)

# Clone the repository
git clone https://github.com/your-username/quickmemo-mcp.git
cd quickmemo-mcp

# Install dependencies and package in editable mode
uv pip install -e .

# Run test suite
uv run pytest -v

# Run the interactive demo
uv run python tests/demo_client.py

Option 2: Running Directly via CLI

# Run server over stdio
quickmemo

πŸ”Œ Client Configuration

Claude Desktop

Add QuickMemo to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quickmemo": {
      "command": "uvx",
      "args": ["--from", "quickmemo", "quickmemo"]
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json in your workspace:

{
  "mcpServers": {
    "quickmemo": {
      "command": "quickmemo"
    }
  }
}

☁️ Deploying to Smithery / Glama

This repository is pre-configured for the Smithery registry with smithery.yaml and Dockerfile.

Install via Smithery CLI

npx -y @smithery/cli install quickmemo --client claude

Manual Registry Deployment

  1. Push your repository to GitHub.

  2. Visit Smithery.ai and sign in.

  3. Import your GitHub repository. Smithery automatically detects smithery.yaml and deploys your MCP server.


πŸ§ͺ Testing

Run the automated test suite:

uv run pytest -v

Output:

tests/test_server.py::TestMemoStore::test_add_and_get PASSED             [ 12%]
tests/test_server.py::TestMemoStore::test_list_and_filter PASSED         [ 25%]
tests/test_server.py::TestMemoStore::test_search PASSED                  [ 37%]
tests/test_server.py::TestMemoStore::test_delete_and_clear PASSED        [ 50%]
tests/test_server.py::TestServerTools::test_tool_workflow PASSED         [ 62%]
tests/test_server.py::TestServerTools::test_clear_memos_tool PASSED      [ 75%]
tests/test_server.py::TestServerResourcesAndPrompts::test_resources PASSED [ 87%]
tests/test_server.py::TestServerResourcesAndPrompts::test_prompts PASSED [100%]

============================== 8 passed in 1.10s ==============================

πŸ“š Deliverables & Learning Documentation


πŸ“„ License

MIT License Β© 2026 QuickMemo MCP Contributors.

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

  • AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Abdullah-Zafarr/quickmemo-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server