List bookmarks
Articles in one list: Home, Archive, Liked, a folder or a tag, with reading progress.
MCP tool instapaper_read → list_bookmarks
read
Returns saved articles from one list, newest first, with title, URL, saved time, reading progress from 0 to 1, and whether each is liked and archived. Choose the list with section: home, archive, liked, folder or tag. Section folder needs folder_id and section tag needs tag. Pass offset to read the next page. Folder and tag together are not allowed.
Parameters
| Name | Type | Description |
|---|---|---|
| section enum | enum | home, archive, liked, folder or tag. Default: home. |
| folder_id integer | integer | Folder ID from list_folders. Needed for section folder. |
| tag string | string | Tag name from list_tags. Needed for section tag. |
| limit integer | integer | Articles per page. Default: 25. |
| offset integer | integer | Number of articles to skip. Default: 0. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "instapaper_read",
"arguments": {
"operation": "list_bookmarks",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"bookmarks": [
{
"bookmark_id": 1893240551,
"title": "How to Salt Pasta Water",
"url": "https://cooking.example.com/salt-pasta-water",
"saved_at": "2026-08-03T18:22:00Z",
"progress": 1,
"liked": false,
"archived": false,
"folder_id": null,
"tags": [
"Cooking"
]
}
],
"total": 212
},
"isError": false
}