Talon for agents
CLI and MCP
Search, read, organize, highlight, and sync your private X library from a terminal or an agent. These interfaces require Talon Premium and a scoped personal API token.
01 · Install
Build the small Go client
The client has no runtime dependency beyond the Go standard library. Clone the Talon source, then build the binary for your machine.
cd clients/talon-cli
go test ./...
go build -o talon .
install -m 0755 talon /usr/local/bin/talon02 · Authenticate
Create a narrow token
Open Settings → API tokens. Choose read-only for research agents, or full access when the agent should organize and sync. Talon stores only a one-way hash.
export TALON_API_TOKEN='talon_…'
# For a local or self-hosted instance only:
export TALON_BASE_URL='https://talon.im'03 · CLI
Human-readable help, JSON output
talon me
talon bookmarks search "pricing tag:launch"
talon bookmarks read 481
talon bookmarks tag 481 "Product Strategy"
talon bookmarks folder 481 Research
talon bookmarks highlight 481 "A useful passage" --share true
talon sync run
Every successful command emits JSON so shell scripts and agents can consume the same
contract. Run talon help for flags, source filters, and examples.
04 · MCP
Expose the same library as tools
The Go binary includes a stdio MCP server. Add this shape to an MCP-capable agent and pass the token through its environment rather than the prompt.
{
"mcpServers": {
"talon": {
"command": "/usr/local/bin/talon",
"args": ["mcp", "serve"],
"env": { "TALON_API_TOKEN": "talon_…" }
}
}
}05 · Skill
Teach an agent the safe workflow
The repository includes skills/talon/SKILL.md. It tells an agent to search
before reading, cite Talon bookmark IDs and original URLs, request narrow token abilities,
and never expose private bookmark text or tokens in logs.