# Readwise MCP > Readwise MCP lets your agent search and pull data from every highlight, book snippet, article, and note you've ever saved in Readwise. It turns your AI client into a personal research assistant that instantly recalls specific quotes or synthesize ideas across your entire digital library. ## Overview - **Category:** brain-trust - **Price:** Free - **Tags:** highlights, reading-list, knowledge-graph, personal-knowledge-management, data-retrieval, research-assistant ## Description Think of this connector as giving your AI an actual memory—a perfect recall system for everything you’ve learned. Instead of relying on vague search terms, your agent digs through the unified data in your Readwise account, pulling together highlights from Kindle books, articles read online, and even saved tweets. You can ask it to find every mention of 'cognitive bias' across five different sources or list all the authors you bookmarked last month. This capability is huge for knowledge workers because it connects ideas that were separated by weeks or months. When you connect this MCP via Vinkius, your AI client becomes less of a general chatbot and more of an expert research partner. You stop managing notes and start synthesizing knowledge. It’s about retrieving the exact quote from 'Sapiens' when you're writing a paper, without having to open five different apps. ## Tools ### check_auth_status Confirms whether your provided Readwise access token is currently valid. ### get_reader_document Retrieves the full content and details for a specific article saved in Readwise Reader using its ID. ### list_books Generates a list of all books and source materials available within your Readwise account. ### list_highlights Lists every single highlight, quote, or snippet you have ever saved across all connected sources. ### list_reader_documents Provides a list of document entries contained within the Readwise Reader section. ### list_tags Retrieves all custom tags and organizational categories you have applied to your notes. ## Prompt Examples **Prompt:** ``` List the most recent 5 books I highlighted on Readwise. ``` **Response:** ``` Using the `list_books` endpoint, I found your latest highlighted sources. The top results are: 'Atomic Habits' (ID: 9234), 'Deep Work' (ID: 8812), and 'Sapiens' (ID: 8129). ``` **Prompt:** ``` Show me the text of the recent document I saved to Reader with the ID 1234. ``` **Response:** ``` Executing `get_reader_document` for ID 1234. I've fetched the full Markdown of the article. It’s titled 'The Future of AI Tools', summarizing context on how autonomous agents reshape programming workflows from start to finish. ``` **Prompt:** ``` Search my highlights for any mentions of 'productivity'. ``` **Response:** ``` I queried `list_highlights` and filtered your collection. You have 15 highlights mentioning 'productivity'. One standout quote from 'Deep Work' says: 'To produce at your peak level you need to work for extended periods with full concentration.' ``` ## Capabilities ### Retrieve all saved highlights List every snippet or quote you have ever bookmarked across your Kindle, Apple Books, and web sources. ### Browse stored books and articles Get a list of all the distinct source materials—books, articles, and documents—that are currently in your Readwise library. ### Analyze knowledge tags Fetch all the custom categories and organizational tags you use to file away your research notes. ### Extract Reader content Pull full article text and details from documents saved specifically in the Readwise Reader app. ## Use Cases ### Writing a literature review A researcher needs to write about the history of AI ethics. Instead of manually searching through old notes and articles, they ask their agent to list all tags related to 'ethics' or 'AI'. The agent then uses `list_highlights` to pull 20 key quotes from various sources, allowing the researcher to start drafting immediately. ### Preparing for a presentation A consultant has read several books on leadership. They need to cite three different viewpoints on 'servant leadership'. They ask their agent to query multiple sources using `list_books` and then filter the results with `list_highlights`, getting perfect, citable quotes from different titles. ### Catching up on saved articles A user saves a lot of interesting but unread long-form articles. They ask their agent to list all documents in the Reader using `list_reader_documents` and then request the full text for one specific article, getting the content without clicking through a web interface. ### Connecting random thoughts A writer has notes from an old book and a new technical article. They ask their agent to pull all highlights using `list_highlights` and then cross-reference those notes with the tags available via `list_tags`. The AI connects two seemingly unrelated ideas into one cohesive concept. ## Benefits - Recall Specific Quotes: You can ask the agent to find every instance of a topic, like 'deep work,' across all sources using `list_highlights`, letting you pull immediate evidence for your writing. - Synthesize Ideas Across Sources: Instead of jumping between Kindle notes and web articles, the AI connects disparate ideas, helping you draft an essay by pulling quotes from different books in one go. - Organize Your Knowledge Base: Use `list_tags` to instantly see how all your research is categorized, allowing you to ask for content based on themes rather than just keywords. - Access Reader Content Directly: You don't need to open the Readwise app; calling `get_reader_document` lets the agent pull the full Markdown text of a saved article directly into your chat window. - See Your Entire Library: By using `list_books`, you get an immediate overview of every source material available, helping you scope out what information is actually retrievable. ## How It Works The bottom line is that after linking the MCP, your AI can instantly search and pull complex information from your private reading history. 1. You first authorize the Readwise MCP connection using your workspace credentials. 2. Next, you provide your unique Readwise Access Token to link the agent to your data source. 3. Then, you simply chat with your AI client, asking it specific questions about your personal notes or requesting a list of sources. ## Frequently Asked Questions **How does the Readwise MCP access my highlights?** The Readwise MCP accesses your data by connecting directly to your authenticated Readwise account. It doesn't just search general web results; it only pulls content you have personally saved and highlighted. **Can I use the list_tags tool for anything other than finding notes?** While primarily used to list available tags, the agent uses this data in conjunction with `list_highlights` to filter your entire knowledge base by specific themes or categories. **What if I need content from a document that isn't an article?** You can use `get_reader_document` for articles, but the general system is designed to pull highlights and snippets from books (like Kindle) as well. **Is this only for reading material, or can it handle other data?** It specializes in your personal educational and research materials—highlights, books, and reader documents. It is not designed to manage emails or calendar events. **Does the Readwise MCP have a limit on how many highlights I can retrieve?** No, it queries your entire unified library of saved data through `list_highlights`, allowing you to review every snippet and quote you've ever saved.