Shiori MCP
Connects Claude to your self-hosted Shiori bookmark manager through its legacy `/api/*` endpoints. You get full CRUD operations: search bookmarks by title, URL, excerpt, or tag; add new bookmarks with Shiori's tag-object format; update existing entries via full JSON payloads or simplified field parameters; and delete by ID. Also exposes tag management (list, rename) and account listing. The developer targets the legacy API because Shiori's v1 is still in development. You'll want this if you're running Shiori and need Claude to search your archived links, bulk-update tags, or manage your read-it-later queue without leaving the conversation.
- tools
- 13
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- May 18, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
shiori_health_checkVerify API connectivity/authentication
Verify API connectivity/authentication
No parameter schema in public metadata yet.
shiori_list_bookmarksList bookmarks with client-side limit/offset
List bookmarks with client-side limit/offset
No parameter schema in public metadata yet.
shiori_search_bookmarksSearch bookmarks by text and/or tag
Search bookmarks by text and/or tag
No parameter schema in public metadata yet.
shiori_get_bookmarkGet one bookmark by id from the bookmark list
Get one bookmark by id from the bookmark list
No parameter schema in public metadata yet.
shiori_get_bookmark_by_urlGet one bookmark by exact URL
Get one bookmark by exact URL
No parameter schema in public metadata yet.
shiori_add_bookmarkAdd a bookmark with optional tags/archive/public flags
Add a bookmark with optional tags/archive/public flags
No parameter schema in public metadata yet.
shiori_update_bookmarkUpdate a bookmark using full Shiori bookmark JSON
Update a bookmark using full Shiori bookmark JSON
No parameter schema in public metadata yet.
shiori_update_bookmark_fieldsUpdate common fields without manually constructing full JSON
Update common fields without manually constructing full JSON
No parameter schema in public metadata yet.
shiori_delete_bookmarkDelete one bookmark id
Delete one bookmark id
No parameter schema in public metadata yet.
shiori_delete_bookmarksDelete bookmark ids from a JSON array
Delete bookmark ids from a JSON array
No parameter schema in public metadata yet.
shiori_list_tagsList tags and bookmark counts
List tags and bookmark counts
No parameter schema in public metadata yet.
shiori_rename_tagRename a tag
Rename a tag
No parameter schema in public metadata yet.
shiori_list_accountsList accounts visible to this session
List accounts visible to this session
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SHIORI_BASE_URL*Base URL of the Shiori instance, e.g. https://shiori.example.com
SHIORI_SESSION_IDsecretExisting Shiori session id; skips login if provided
SHIORI_USERNAMEShiori username; required unless SHIORI_SESSION_ID is set
SHIORI_PASSWORDsecretShiori password; required unless SHIORI_SESSION_ID is set
Readme
Shiori MCP
A Model Context Protocol (MCP) server for Shiori, the self-hosted bookmark and read-it-later manager.
Capabilities
- Verify Shiori connectivity and authentication
- List bookmarks
- Search bookmarks by title, URL, excerpt, and tag
- Get one bookmark by id or exact URL from the bookmark list
- Add bookmarks with Shiori's required tag-object format
- Update bookmarks via either a full-bookmark payload or common field parameters
- Delete bookmarks by id list
- List tags and bookmark counts
- Rename tags
- List accounts visible to the authenticated session
Installation
pipx install git+https://github.com/rusty4444/shiori-mcp.git
Or from a checkout:
python -m venv .venv
source .venv/bin/activate
pip install -e .
Configuration
Details
- Repository
- github.com/rusty4444/shiori-mcp
- Website
- github.com/rusty4444/shiori-mcp
- Category
- Productivity & Office
- Package
shiori-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from rusty4444
Related Productivity & Office MCP servers
View all
Trelloscaratec/trellio-mcpMCP server for Trello — manage boards, lists, cards, attachments and more via Claude or Gemini0stars
Geo Figure (지리 시험 지도·그래프)skyblue3925-svg/geo-figure-mcp지리 시험용 지도·그래프를 실제 통계로, 도형 하나하나 고칠 수 있는 PPTX·HWPX로 만든다.0stars
Dart Querystandardbeagle/dart-queryDart AI task management MCP with batch operations, DartQL selectors, CSV import, zero context rot0stars
Hemrock MCPtdavidson/mcp-hemrockHemrock financial modeling prompts: context primers, task prompts, checks, and best practices.0stars
Travelpayouts Mcptheyahia/travelpayouts-mcpMCP server for Travelpayouts API -- flight search, popular routes, price calendar.0stars