MCP Local File Saver
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., "@MCP Local File Saver list all my saved notes"
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 Local File Saver
A Python-based MCP server for Claude Desktop that lets you save, append, read, and list local text notes.
Features
Save a note as a local
.txtfileAppend new content to an existing note
Append Claude’s response to a note
Read a note by title
List all saved notes
Expose saved notes through an MCP resource
Summarize note content with an MCP prompt
Related MCP server: NotePilot
Built With
Python
MCP Python SDK
Claude Desktop
uv
Project Structure
mcp-local-file-saver/
├── main.py
├── .gitignore
├── pyproject.toml
├── uv.lock
└── notes/ # ignored from gitMCP Capabilities
Tools
save_note(title, content)append_note(title, content)append_response_to_note(note_name, response_text)read_note(title)list_notes()
Resources
notes://all
Prompts
summarize_note(...)
Example Use Cases
You can ask Claude things like:
Save this response to
mcp-learningAppend that answer to
oracle-notesRead my
fav playersnoteList all my saved notes
Summarize my
interview prepnote
Setup
1. Clone the repo
git clone <your-repo-url>
cd mcp-local-file-saver2. Install dependencies
uv sync3. Run locally with MCP Inspector
uv run mcp dev main.py4. Run with Claude Desktop
Add the server to your Claude Desktop config using your local Python interpreter inside .venv.
Example:
{
"mcpServers": {
"Local File Saver": {
"command": "/absolute/path/to/project/.venv/bin/python",
"args": [
"/absolute/path/to/project/main.py"
]
}
}
}Notes
Notes are stored locally in the
notes/folderThe
notes/folder is ignored in gitThe server runs over
stdio
Why I Built This
I built this project to get hands-on experience with MCP by creating a practical local productivity tool. It helped me understand how MCP tools, resources, and prompts work together in a real Claude Desktop integration.
Future Improvements
Support Apple Pages
Support Google Docs
Search notes by keyword
Read notes by exact filename
Add tags or metadata to notes
Add better summarization workflows
License
MIT
Available Tools
5 toolsappend_noteB
Append content to an existing note. Fails if the note does not exist.
Inputs: title (required), content (required). Returns: result
append_response_to_noteC
Append Claude's response text to an existing note.
Inputs: note_name (required), response_text (required). Returns: result
list_notesB
List all .txt files in the notes directory.
Inputs: no named parameters. Returns: result
read_note_by_filenameA
Read a note by exact filename. Use notes://all to find the filename first.
Inputs: filename (required). Returns: result
save_noteC
Save a note to a local text file.
Inputs: title (required), content (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
save_note, append_note, and append_response_to_note have distinct purposes, though append_note and append_response_to_note overlap in that both append content to a note; the latter is specialized for Claude's response. The distinction is clear from descriptions.
Most tools follow a consistent verb_noun pattern (save_note, append_note, read_note_by_filename, list_notes), but append_response_to_note adds a qualifier that breaks the pattern slightly. Still largely predictable.
Five tools are well-scoped for a local file note-taking server, covering create, append, read, and list operations. No redundant or trivial tools.
Core operations like create, append, read, and list are present, but there is no delete, rename, or update tool. Agents may hit dead ends when needing to remove or modify notes beyond appending.
Maintenance
Related MCP Connectors
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Python-based MCP server that allows users to create, read, and manage digital sticky notes with Claude integration for AI-powered note summarization.-
- FlicenseBqualityDmaintenanceA Python MCP server that exposes note management tools (create, search, update, delete notes) over stdio, enabling Claude AI to manage notes through natural language conversation.8-
- AlicenseAqualityDmaintenanceA beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.6MIT
- AlicenseAqualityDmaintenanceA note-taking MCP server for Claude-based agents that provides persistent markdown files for easily referable notes, supporting create, read, update, append, and delete operations.5Apache 2.0