Glasp is a social web highlighter — highlights and notes on articles, PDFs, YouTube videos and Kindle books, saved to glasp.co 
. This page is the plan for integrating Glasp with Claude Code and the federated wiki, so highlights flow into the research anarchive alongside video and audio clips. Part of the Media Plan.
## MCP Connector
Glasp ships an official hosted MCP server — read-only, OAuth, explicitly supporting Claude Code — glasp.co/mcp . Register it with:
claude mcp add --transport \ http glasp https://glasp.co/api/mcp
Then run `/mcp` in an interactive Claude session to complete the OAuth sign-in. Once connected you can ask your own library in natural language — "what have I highlighted about spaced repetition?" — and pull saved passages into any answer. The connector can only read; it can never post, edit, or delete.
## REST API
The Glasp API is a small RESTful API at `https://api.glasp.co`, authenticated with a Bearer token from settings . Unlike the MCP connector it can write as well as read:
- `GET /v1/highlights/export` — all highlights, cursor pagination, `updatedAfter` incremental sync (100 req/min)
- `POST /v1/highlights/create` — batch-create up to 100 highlights (15 req/min)
- `PATCH /v1/highlights/update` — edit text, note, color, location (30 req/min)
- `DELETE /v1/highlights/delete` — one highlight or a whole document (15 req/min)
- `GET /v1/kindle-highlights/export` — Kindle highlights, read-only (100 req/min)
curl -s "https://api.glasp.co/v1/highlights/export?updatedAfter=2026-07-01T00:00:00Z" \ -H "Authorization: Bearer $GLASP_ACCESS_TOKEN"
Responses are grouped per source document — title, author, url, category (`article | video | tweet | pdf | book`), tags, summary — with the highlight array inside: text, note, color, location and timestamps. A shape that maps naturally onto wiki page JSON: document → page, highlight → item.
## Glasp to Fedwiki
The planned integration is a Glasp ToFedwiki Skill — a sibling of the youtube-archive skill: - pull highlights incrementally with `updatedAfter`, keeping a last-sync cursor - write one wiki page per source document, highlights as quoted markdown items with notes - tag pages by Glasp category so articles, videos and Kindle books land in the right neighbourhood - optionally push the other way — quotes captured in the wiki up to Glasp via the create endpoint
## See
- Media Plan — the integrated archiving strategy this plan belongs to - yt-dlp and Downloading Audio — the video and podcast capture tools
# Assets
glasp-plan