plintho-mcp 0.1.0

MCP server + CLI for the plintho voice journal

plintho-mcp

A small CLI + MCP server that lets any MCP-capable client (Claude Desktop, Cursor, Cline, Zed, …) query the plintho voice-journal backend on behalf of a single user.

Install

Direct from GitHub (no PyPI release yet):

pipx install 'git+https://github.com/vtech-ai/plintho-mcp.git'

Or with pip:

pip install 'git+https://github.com/vtech-ai/plintho-mcp.git'

Local checkout while developing:

git clone https://github.com/vtech-ai/plintho-mcp.git
cd plintho-mcp
pipx install -e .

Requires Python 3.11+. Runtime deps: mcp, httpx. The package does not pull in any of the plintho backend's heavy dependencies.

Pair this device with your account

$ plintho-mcp login --name "MacBook Cursor"
配对码: WXYZ-2345
请在 plintho iOS app → Settings → MCP Access 输入此码
等待中...
✓ 已登录为 user-abc

The token is saved to ~/.plintho/mcp_token (mode 600). The plaintext exists only on this machine; the server stores only its sha256 hash.

Wire into your MCP client

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "plintho": { "command": "plintho-mcp" }
  }
}

Claude Code

claude mcp add plintho -- plintho-mcp

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "plintho": { "command": "plintho-mcp" }
  }
}

Same command key works for Cline / Zed / Continue / any stdio-MCP client.

Tools exposed

Tool	What it does
list_events_by_date	All events on a given date (YYYY-MM-DD or today/yesterday).
get_event_detail	One event's note (Markdown) + raw utterances.
search_events	Free-text search across event titles/summaries/notes, optional date.
search_utterances	Substring search across raw transcribed utterances.
get_daily_summary	Daily summary (日报) for a given date.

All tools are scoped to the user the token was issued to — there is no user_id parameter and the server enforces ownership on every call.

Other commands

plintho-mcp whoami             # show current user_id / token name
plintho-mcp logout             # delete the local token file
plintho-mcp login --force      # re-pair (replaces existing token locally)

To revoke a token server-side, use the iOS app → Settings → MCP Access.

Environment variables

Var	Default	Purpose
PLINTHO_API_BASE	https://api.plintho.app	Backend URL.
PLINTHO_HOME	~/.plintho	Token + config directory.