Readwise Reader

An MCP server for the Readwise Reader API to access and manage your articles and highlights.

A Model Context Protocol (MCP) server for the Readwise Reader API, built with TypeScript and the official Claude SDK.

- Secure Authentication: Uses environment variables for token storage
- Document Management: Save, list, update, and delete documents with complete metadata
- Tag Management: List and filter by tags
- Rich Filtering: Filter documents by location, category, tags, and more
- Pagination Support: Handle large document collections
- LLM-Friendly Content: HTML content automatically converted to clean text using r.jina.ai
- Complete Data Access: Returns full document information including content, metadata, and timestamps

For detailed information about the Readwise Reader API endpoints, parameters, and examples, please refer to the official API documentation:

This MCP server implements all the core endpoints described in the official documentation.

Get your Readwise access token from:https://readwise.io/access_token

{ "mcpServers": { "readwise-reader": { "command": "node", "args": ["/path/to/your/reader_readwise_mcp/dist/index.js"], "env": { "READWISE_TOKEN": "your_readwise_access_token_here" } } } }

- /path/to/your/reader_readwise_mcpwith the actual path to this project directory
- your_readwise_access_token_herewith your actual Readwise access token

Save a document (URL or HTML content) to Readwise Reader.

- url(required): URL of the document to save
- html(optional): HTML content of the document
- tags(optional): Array of tags to add
- location(optional): Location to save (new,later,shortlist,archive,feed)
- category(optional): Document category (article,book,tweet,pdf,email,youtube,podcast)

List documents from Readwise Reader with optional filtering. Returns complete document information including metadata and LLM-friendly text content.

- id(optional): Filter by specific document ID
- updatedAfter(optional): Filter documents updated after this date (ISO 8601)
- location(optional): Filter by document location
- category(optional): Filter by document category
- tag(optional): Filter by tag name
- pageCursor(optional): Page cursor for pagination
- withHtmlContent(optional): ⚠️PERFORMANCE WARNING: Include HTML content in the response. This significantly slows down the API. Only use when explicitly requested by the user or when raw HTML is specifically needed for the task.
- withFullContent(optional): ⚠️PERFORMANCE WARNING: Include full converted text content in the response. This significantly slows down the API as it fetches and processes each document's content. Only use when explicitly requested by the user or when document content is specifically needed for analysis/reading. Default: false for performance.

Returns:Complete document objects with all available fields:

- id,title,author,url,source_url,summary
- published_date,image_url,location,category
- tags,created_at,updated_at
- content: LLM-friendly text content (converted from source_url or url via r.jina.ai)

- id(required): Document ID to update
- title(optional): New title
- author(optional): New author
- summary(optional): New summary
- published_date(optional): New published date (ISO 8601)
- image_url(optional): New image URL
- location(optional): New location
- category(optional): New category

Search documents in Readwise Reader by topic using regex matching on title, summary, notes, and tags.

- searchTerms(required): Array of search terms to match against document content (case-insensitive regex matching)

Returns:Search results with matching documents including:

- Search terms used
- Total number of matches
- Complete document objects with all available metadata (same fields asreadwise_list_documents)

The server requires a Readwise access token to be provided via theREADWISE_TOKENenvironment variable. This token is used to authenticate all API requests to Readwise Reader.

Security Note: The token is stored in your MCP configuration and never exposed through Claude or the tools interface.

- Default: 20 requests/minute
- Document CREATE/UPDATE: 50 requests/minute
- 429 responses include "Retry-After" header

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.

A Model Context Protocol (MCP) Server for https://joplinapp.org/ that enables note access through the https://modelcontextprotocol.io. Perfect for integration with AI assistants like Claude.

A service for reading, writing, and managing markdown documentation with frontmatter metadata.

Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.

An MCP server for interacting with Obsidian notes. Requires the OBSIDIAN_VAULT_PATH environment variable to be set.

Interact with your Obsidian vault using natural language.

Interact with your Obsidian vault using the Local REST API plugin, enabling LLMs to access and manage your notes.

Interact with your Obsidian notes and vaults using the Local REST API plugin.

A server for interacting with your Obsidian vault.