Text Saver

An MCP service that allows Claude to save text to local files

Note-taking tools File system #Text Storage #File Management #Security Protection .Python

rating : 2 points

downloads : 19

update time : 2025-04-28

Installation

Copy the following command to your Client for configuration

{
     "mcpServers": {
       "text-saver": {
         "command": "/full/path/to/python",
         "args": [
           "/full/path/to/text_saver_mcp.py"
         ],
         "cwd": "/path/to/writable/directory",
         "host": "127.0.0.1",
         "port": 8080,
         "timeout": 30000
       }
     }
   }

Note: Your key is sensitive information, do not share it with anyone.

🚀 Text Saver MCP

A Claude MCP (Model Context Protocol) server that allows Claude to save text to files on your local file system.

🚀 Quick Start

A Claude MCP (Model Context Protocol) server enables Claude to save text into files on your local file system.

✨ Features

📝 Save text inputs to files using simple commands.
🕒 Automatically generate timestamp filenames when no filename is provided.
🔒 Built - in security features, including filename validation and sanitization.
🚫 Protection against directory traversal attacks.
⚠️ Comprehensive error handling and logging.
✅ File size limits to prevent file system abuse.

📦 Installation

Dependencies

Python 3.8 or higher.
Claude Desktop application.

Setup

Clone this repository.
Install the required dependencies:
```
pip install -r requirements.txt
```

Configure Claude Desktop to use the MCP server: Open your Claude Desktop configuration file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json Add the following configuration:

{
  "mcpServers": {
    "text-saver": {
      "command": "/full/path/to/python",
      "args": [
        "/full/path/to/text_saver_mcp.py"
      ],
      "cwd": "/path/to/writable/directory",
      "host": "127.0.0.1",
      "port": 8080,
      "timeout": 30000
    }
  }
}

Make sure to replace the paths with the actual locations on your system.

Restart Claude Desktop.

💻 Usage Examples

Basic Usage

After setting up, you can ask Claude to save text to a file using natural language:

“Save this text to a file”
“Save this information to a file named notes.txt”
“Write this content to a text file named project-ideas.txt” The text will be saved to the directory specified in the configuration.

🔧 Technical Details

Security Features

File size limit: Prevents saving overly large files (default: 10MB).
Filename validation: Ensures filenames are safe and do not contain path traversal attempts.
Sanitization: Automatically sanitizes unsafe filenames.
Path control: Can only save files in the specified directory.

Troubleshooting

Common Issues

"spawn python ENOENT" error: This error indicates that Claude cannot find the Python executable. Use the actual full path of Python in the configuration file:
```
# Find your Python path
which python

# Then use this path in the configuration
```
"Read - only file system" error: This means the script does not have permission to write to the specified directory. Make sure you set up a writable directory.
Permission issues: Ensure that the directory where files are saved has appropriate write permissions:
```
chmod 755 /path/to/save/directory
```