Skip to main content
Glama
MCP Local File Saver

MCP Local File Saver

by omcar04

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 .txt file

  • Append 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 git

MCP 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-learning

  • Append that answer to oracle-notes

  • Read my fav players note

  • List all my saved notes

  • Summarize my interview prep note

Setup

1. Clone the repo

git clone <your-repo-url>
cd mcp-local-file-saver

2. Install dependencies

uv sync

3. Run locally with MCP Inspector

uv run mcp dev main.py

4. 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/ folder

  • The notes/ folder is ignored in git

  • The 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 tools
append_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

    B3.2/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Five tools are well-scoped for a local file note-taking server, covering create, append, read, and list operations. No redundant or trivial tools.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      A 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      A beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      5
      Apache 2.0