Instapaper MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| INSTAPAPER_PASSWORD | Yes | Your Instapaper account password | |
| INSTAPAPER_USERNAME | Yes | Your Instapaper account email address | |
| INSTAPAPER_CONSUMER_KEY | Yes | Your Instapaper API Consumer Key | |
| INSTAPAPER_CONSUMER_SECRET | Yes | Your Instapaper API Consumer Secret |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_bookmarksB | List bookmarks from a specific folder or search results. Retrieve unread, archived, or starred articles with optional limit. This is the primary way to browse your reading list. Supports filtering by folder, limit, and sync parameters for efficient bulk data retrieval. |
| search_bookmarksB | Find bookmarks by searching through titles, URLs, and descriptions. Supports optional filtering by folder (use "unread", "archive", "starred", or a specific folder_id) and result limits. Useful for discovering articles on specific topics or finding previously saved content. |
| get_article_contentA | Retrieve the complete text content of a single article. Use this to analyze, summarize, or process the full article text. Requires a bookmark ID. Returns the article as plain text. |
| get_articles_content_bulkB | Fetch the complete text of multiple articles simultaneously for efficient bulk analysis. Provide an array of bookmark IDs. Articles are retrieved in parallel for best performance. Each article is returned with its ID, content, or error status. Ideal for synthesizing information across multiple sources, comparing perspectives, or comprehensive research analysis. |
| list_highlightsA | Retrieve all highlights/excerpts saved from a specific article. Shows all the important passages you have highlighted in that bookmark, useful for reviewing key points and important takeaways. |
| add_bookmarkA | Save an article or web page to Instapaper. Use this when the user wants to save a URL for later reading. Returns the bookmark ID, title, and URL. You can optionally provide a title, description/notes, and a folder ID to organize the article. |
| add_private_bookmarkA | Save private content without a URL to Instapaper (e.g., from emails, notebooks, clipped text, Slack messages). Private bookmarks are not shared and don't have URLs. Perfect for personal notes, clipped content, or information from sources without URLs. Requires HTML content to be provided. |
| star_bookmarkA | Mark a bookmark as starred/important. Starring articles highlights them in your Instapaper library and helps you track your favorite or most valuable reads. |
| unstar_bookmarkA | Remove the star from a bookmark. Use this when an article is no longer a favorite or needs to be deprioritized in your library. |
| archive_bookmarkA | Move a bookmark to the archive. Archiving removes articles from your unread queue without deleting them, useful for marking articles as done or temporarily hiding them. The bookmark can be unarchived later. |
| unarchive_bookmarkA | Restore a bookmark from the archive back to your unread list. Use this to bring back articles you want to read or reconsider. |
| move_bookmarkB | Organize a bookmark by moving it to a specific folder. Use this to categorize articles (e.g., move research articles to a "UX Research" folder). Requires both the bookmark ID and target folder ID. |
| move_bookmarks_bulkA | Move multiple bookmarks to the same folder in parallel. While Instapaper API only supports single moves, this tool batches them efficiently using parallel requests. Ideal for organizing large sets of articles after search or bulk discovery. Returns success count and any failures. |
| star_bookmarks_bulkB | Mark multiple bookmarks as starred in parallel. Use this to quickly highlight a set of important articles you want to track or prioritize. Returns success count and any failures. |
| unstar_bookmarks_bulkA | Remove stars from multiple bookmarks in parallel. Use this to deprioritize a group of articles at once. Returns success count and any failures. |
| archive_bookmarks_bulkA | Move multiple bookmarks to archive in parallel. Use this to quickly mark a set of articles as done or hide them from your unread queue. Returns success count and any failures. |
| unarchive_bookmarks_bulkA | Restore multiple bookmarks from archive in parallel. Use this to bring back a group of articles to your unread list. Returns success count and any failures. |
| update_read_progress_bulkA | Update reading progress for multiple bookmarks in parallel. Useful for batch-updating progress on a set of related articles or bulk-marking articles as read. Progress ranges from 0.0 (not started) to 1.0 (finished). Returns success count and any failures. |
| list_foldersB | Retrieve all folders in your Instapaper account. This shows custom folders you have created for organizing articles. Returns folder names, IDs, and positions. |
| create_folderC | Create a new folder for organizing bookmarks. Provide a folder name/title. Folders help categorize articles by topic, project, or any organizational system you prefer. |
| delete_folderA | Remove a folder from your Instapaper account. When a folder is deleted, all bookmarks in it are automatically moved to the unread section. Use this to clean up unused folders. |
| reorder_foldersC | Reorder your folders in a custom sequence. Provide an array of folder IDs with their desired positions. This helps organize your folder structure for better workflow. |
| add_highlightB | Add a highlight (excerpt) to an article. Specify the text to highlight and its position in the article. Use this to mark important passages, quotes, or key insights for later reference. |
| delete_highlightC | Remove a specific highlight from an article. Use this to clean up highlights or remove excerpts you no longer need. |
| update_read_progressB | Track reading progress on a bookmark. Provide a progress value between 0.0 (not started) and 1.0 (finished). Useful for tracking where you left off in long articles or research papers. |
| delete_bookmarkA | Permanently remove a bookmark from Instapaper. This action cannot be undone. Use this when the user wants to delete an article they no longer need. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| weekly_reading_digest | Generate a weekly digest of unread articles organized by topic |
| recommend_next_read | Suggest which article to read next based on interests and starred content |
| research_synthesis | Synthesize insights from articles on a specific topic |
| organize_backlog | Suggest how to organize unread articles into folders |
| archive_candidates | Identify old unread articles that might be worth archiving |
| save_as_private_bookmark | Guidelines for saving content to private bookmarks (emails, notes, clipped text, etc.) |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Unread Bookmarks | All unread articles in your Instapaper account |
| Archived Bookmarks | All archived articles |
| Starred Bookmarks | All starred articles |
| Folders | List of all folders |
TDQS
Scored across 26 tools
Most tools target clearly distinct resource+action pairs (folders, highlights, article content, bookmark state changes). The main risk is the five single/bulk pairs (star_bookmark vs star_bookmarks_bulk, archive/bookmark vs archive_bookmarks_bulk, etc.), which an agent could misselect, though the descriptions clearly mark the plural batch variants. list_bookmarks vs search_bookmarks also overlap slightly but are adequately differentiated.
Nearly all tools use consistent snake_case verb_noun patterns (list_folders, add_highlight, archive_bookmark). Minor deviations: bulk suffix placement and pluralization vary (star_bookmarks_bulk vs star_bookmark, update_read_progress_bulk, get_articles_content_bulk), and add_private_bookmark mixes a qualifier into the noun. Still readable and predictable overall.
26 tools is heavy for what is essentially bookmark management, largely because nearly every bookmark action has both a single and a bulk variant (10 of 26 are bulk tools). The bulk tools are defensible for efficiency, but the surface feels inflated relative to the domain.
Bookmark lifecycle is thoroughly covered: create (URL and private HTML), delete, browse/search, fetch content, move, archive/unarchive, star/unstar, read progress, plus highlights and folders. Gaps exist: no update/edit bookmark metadata (title, description) and no rename_folder or update_folder, so the folder surface is only partially complete.