textview-mcp
Let AI remember everything for you.
Quick Start · Tools · Use Cases · 中文 · 日本語 · 한국어
textview-mcp is an MCP server that connects AI assistants (Claude, Cursor, Windsurf, etc.) to TextView — a cloud-based note-taking platform designed for AI agents.
Think of it as persistent memory for your AI: meeting notes, research findings, code snippets, daily journals — anything your AI generates can be saved, searched, and retrieved across sessions.
Why?
AI conversations are ephemeral. You have a great brainstorming session with Claude, close the window, and it's gone. textview-mcp solves this:
- AI writes, you review — Let your AI agent save documents directly. Review them later on textview.cn from any device.
- Cross-session memory — Claude in one conversation can read what Claude in another conversation wrote.
- Cross-tool sync — Save from Cursor, read from Claude Desktop, review on your phone.
- Rich formatting — Documents are stored as rich text (HTML), not plain text.
Quick Start
1. Get your API token
Sign up at textview.cn, click your avatar → API Token → Generate.
2. Configure your AI tool
Claude Desktop
Edit claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"textview": {
"command": "npx",
"args": ["-y", "textview-mcp"],
"env": {
"TEXTVIEW_TOKEN": "tv_your_token_here"
}
}
}
}
Restart Claude Desktop after saving.
Cursor
Create or edit .cursor/mcp.json in your project root:
{
"mcpServers": {
"textview": {
"command": "npx",
"args": ["-y", "textview-mcp"],
"env": {
"TEXTVIEW_TOKEN": "tv_your_token_here"
}
}
}
}
Windsurf
Go to Settings → MCP and add:
{
"mcpServers": {
"textview": {
"command": "npx",
"args": ["-y", "textview-mcp"],
"env": {
"TEXTVIEW_TOKEN": "tv_your_token_here"
}
}
}
}
Claude Code
claude mcp add textview -- npx -y textview-mcp
Then set the environment variable TEXTVIEW_TOKEN=tv_your_token_here.
3. Start using it
Just ask your AI naturally:
"Save this conversation as a document called 'Meeting Notes March 11'"
"Show me my recent documents"
"Find my notes about the API redesign"
Tools
| Tool | Description |
|---|---|
save_document | Save a new document to TextView |
list_documents | List documents (with optional search) |
get_document | Retrieve a document by ID |
update_document | Update an existing document's title or content |
Use Cases
Daily Journal
"Save a journal entry for today: summarize what we discussed and the decisions we made."
Research Assistant
"Save this research summary about MCP protocols to my notes."
Code Documentation
"Document the architecture of this project and save it to TextView."
Meeting Notes
"We just finished our sprint planning. Save the action items as a document."
Cross-Session Context
"Check my notes — did we decide on PostgreSQL or MySQL last week?"
Requirements
Environment Variables
| Variable | Required | Description |
|---|---|---|
TEXTVIEW_TOKEN | Yes | API token (starts with tv_), generated at textview.cn |
How It Works
Your AI Tool (Claude, Cursor, etc.)
↕ MCP Protocol (stdio)
textview-mcp (this package)
↕ HTTPS
TextView Cloud API
↕
Your Documents (accessible from any device)
Development
git clone https://github.com/mrliuzhiyu/textview-mcp.git
cd textview-mcp
npm install
npm run dev
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
Built by TextView — AI-native note-taking for the agent era.