mcp.txt/README.md

mcp.txt

A minimal MCP server for managing text files from Claude (web, desktop, and iOS).

Setup

bun install

Usage

DATA_DIR=~/Documents/claude-files PORT=3100 bun start

• DATA_DIR — directory the server reads/writes from (default: ~/Documents/claude-files)
• PORT — HTTP port (default: 3001)

Tools

Tool	Description
list_files	List files and directories in a given path
read_file	Read the contents of a text file
create_file	Create a new file (fails if it already exists)
edit_file	Replace the contents of an existing file

All paths are relative to DATA_DIR. Path traversal is rejected. There is no delete — by design.

Connect to Claude

1. Run the server
2. Expose via HTTPS tunnel (e.g. Sneakers, ngrok, Cloudflare Tunnel)
3. Claude.ai → Settings → Integrations → Add Custom Integration
4. Set the URL to https://your-tunnel/mcp

Works on web, desktop, and iOS.