quickmemo-mcp
QuickMemo MCP Server πβ‘
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.jsonor custom path).π Marketplace & Registry Ready: Preconfigured with
smithery.yamlandDockerfilefor 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 |
|
| Saves a new memo or snippet with optional category and tags. |
|
| Lists saved memos with optional category and tag filtering. |
|
| Retrieves full content and metadata for a specific memo. |
|
| Performs keyword search across title, content, tags, and category. |
|
| Deletes a memo by ID. |
| None | Empties the memo store. |
2. Resources (Dynamic Context Streams)
Resource URI | MIME Type | Description |
|
| Formatted dynamic markdown digest of all stored memos. |
|
| Real-time statistics (total memos, categories breakdown, tag distribution). |
3. Prompts (Pre-Engineered Workflow Templates)
Prompt Name | Arguments | Description |
|
| Synthesizes saved memos into key takeaways and an actionable checklist. |
| 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.pyOption 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.jsonWindows:
%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 claudeManual Registry Deployment
Push your repository to GitHub.
Visit Smithery.ai and sign in.
Import your GitHub repository. Smithery automatically detects
smithery.yamland deploys your MCP server.
π§ͺ Testing
Run the automated test suite:
uv run pytest -vOutput:
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
π Existing MCP Hands-On Evaluation:
docs/EXISTING_MCP_EXPERIENCE.mdπ MCP Architecture & Fundamentals Guide:
docs/MCP_FUNDAMENTALS.mdπ» Interactive Live Demo Script:
tests/demo_client.pyβοΈ Smithery Configuration:
smithery.yaml
π License
MIT License Β© 2026 QuickMemo MCP Contributors.
This server cannot be installed
Maintenance
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
FlicenseAqualityFmaintenanceAn open-source server implementing the Model Context Protocol (MCP) that enables capturing insights from AI sessions and transforming them into persistent, searchable knowledge accessible across tools.78- AlicenseAqualityAmaintenanceA local-first MCP server for shared memory across AI tools, enabling context capture and resume across sessions.26624Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA lightweight, intelligent note-organizing server that acts as an AI-powered personal memory vault for capturing, organizing, and retrieving insights using FastMCP and SQLite.2
- AlicenseNot gradedqualityBmaintenanceA high-performance personal Model Context Protocol (MCP) server built with the FastMCP Python framework.MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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