🧠 Custom MCP Server for AI-Powered Sticky Notes
947 downloads
Not rated
About
A lightweight server built with FastMCP + uv, enabling natural language commands to manage notes, reminders & productivity within Claude Desktop.
Details
- Author
- kishorekrrish3
- Downloads
- 947
- Categories
- Knowledge Base, AI, Productivity
Jump to
- Natural language note creation via AI assistants
- Instant retrieval of previously saved notes
- Persistent local storage in a .txt file
- Fast Python environment using the uv package manager
- Automatic tool registration inside Claude Desktop
- Extensible design for adding new tools
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🧠 Custom MCP Server for AI-Powered Sticky NotesCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.12+, the uv package manager, and optionally Claude Desktop. Run uv init ., then uv add "mcp[cli]", and finally uv run mcp install main.py to register the server. After restarting Claude Desktop (if used), the tools add_note, get_notes, and search_notes become available for natural language note management.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udde0 custom mcp server for ai-powered sticky notes": {
"Custom-MCP-Server-for-AI-Powered-Sticky-Notes": {
"command": "uv",
"args": [
"init",
"."
]
}
}
}
}McpServers
{
"Custom-MCP-Server-for-AI-Powered-Sticky-Notes": {
"command": "uv",
"args": [
"init",
"."
]
}
}<div align="center">
🧠 NoteFlow
AI-Powered Sticky Notes via a Custom MCP Server
A lightweight Model Context Protocol (MCP) server that enables AI assistants to create, retrieve, and manage sticky notes using natural language.
Turn simple conversations into persistent notes for productivity, brainstorming, and reminders.
<br>
[
]()</div>
---
📖 What is NoteFlow?
NoteFlow is a custom MCP (Model Context Protocol) server designed to bring persistent sticky notes into AI workflows.
Instead of manually managing notes in separate apps, users can simply ask their AI assistant to create, store, or retrieve notes using natural language.
When integrated with AI clients like Claude Desktop, NoteFlow allows the assistant to:
Save reminders
Store ideas
Retrieve previously saved notes
Maintain persistent context across conversations
All notes are stored locally in a simple
.txt file, making the system lightweight, transparent, and fully customizable.---
✨ Features
| Feature | Description |
| ------------------------------------- | ---------------------------------------------------------- |
| 🧠 Custom MCP Server | Implements a fully functional MCP server using FastMCP |
| 📝 Natural Language Note Creation | AI assistants can add notes directly through commands |
| 📖 Note Retrieval | Retrieve previously saved notes instantly |
| 💾 Persistent Storage | Notes are stored locally in a
.txt file || ⚡ Fast Python Environment | Uses the modern
uv package manager || 🔗 Claude Desktop Integration | Automatically registers tools inside Claude |
| 🧩 Extensible Design | Easily add new tools like delete, tag, or categorize notes |
---
🏗️ System Architecture
Request Flow
``
mermaid
graph TD
A[👤 User Prompt] --> B[Claude Desktop AI]
B --> C[MCP Client]
C --> D[Custom MCP Server - FastMCP]
D --> E{Command Type}
E -->|Add Note| F[Write to notes.txt]
E -->|Retrieve Notes| G[Read notes.txt]
E -->|List Notes| H[Parse Stored Notes]
F --> I[Return Confirmation]
G --> I
H --> I
I --> B
`
---
MCP Workflow
The MCP server exposes custom tools that the AI client can call.
1️⃣ The user asks the AI assistant to save or retrieve a note
2️⃣ The assistant sends a tool request through MCP
3️⃣ The FastMCP server processes the request
4️⃣ Notes are written to or retrieved from
5️⃣ The response is returned to the AI client
This architecture allows AI assistants to interact with local tools safely and efficiently.
---
🛠️ Technology Stack
Core Backend
| Component | Technology |
| --------------------- | ----------------- |
| Programming Language | |
| MCP Server Framework | FastMCP |
| Package Manager | uv |
| Storage | Local .txt file |
| AI Client Integration | Claude Desktop |
---
📂 Project Structure
`text
ai-sticky-notes-mcp/
│
├── main.py # MCP server logic (tools, prompts, handlers)
├── notes.txt # Persistent storage for sticky notes
└── README.md # Project documentation
`
---
🚀 Installation & Setup
Prerequisites
Python 3.12+
Claude Desktop (optional but recommended)
---
1️⃣ Install
Windows (PowerShell)
powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
`
Mac / Linux (curl)
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
`
Or with
bash
wget -qO- https://astral.sh/uv/install.sh | sh
`
---
2️⃣ Initialize the Project
bash
uv init .
`
---
3️⃣ Add MCP Dependency
bash
uv add "mcp[cli]"
`
---
🏃 Running the MCP Server
Place all server logic inside .
Then install the MCP server:
`bash
uv run mcp install main.py
`
This registers the MCP server so AI clients can discover it automatically.
---
🔗 Claude Desktop Integration
If Claude Desktop is installed:
1️⃣ Run:
bash
uv run mcp install main.py
`
2️⃣ Claude will automatically detect your MCP server.
3️⃣ Restart Claude if tools do not appear:
Open Task Manager
End the Claude Desktop process
Restart the app
Your MCP tools should now be available.
---
🌐 MCP Tools Example
Your server can expose tools such as:
| Tool | Description |
| -------------- | ------------------------------- |
| | Save a new sticky note |
| get_notes | Retrieve all notes |
| search_notes | Find notes containing a keyword |
Example interaction:
`
User: Remember that I need to finish my ML assignment tonight.
Claude: Note saved successfully.
---
⚙️ Configuration
| Setting | File | Description |
| ------------------ | -------------- | ---------------------------------- |
| Notes Storage | | Local file where notes are stored |
| MCP Tools | main.py | Define tools and commands |
| Client Integration | Claude Desktop | Registers MCP server automatically |
---
🐛 Known Issues & Troubleshooting
MCP server not visible in Claude
Restart the Claude desktop application:
1. Open Task Manager
2. End the Claude process
3. Restart the app
---
Notes not saving
Ensure that:
notes.txt` exists in the project directoryThe MCP server has permission to write to the file
---
🔮 Future Improvements
📂 Note tagging and categorization
🧠 Semantic search using embeddings
🗑️ Delete or edit notes
☁️ Cloud storage integration
🔗 Multi-agent MCP workflows
---
<div align="center">
<br>
<i>Making AI assistants remember what matters.</i>
<br><br>
<b>NoteFlow</b> — because ideas shouldn't disappear.
</div>
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
