MCP.Market

Shiori MCP server

by rusty4444·io.github.rusty4444/shiori-mcp·v0.1.0
No reviews yet

MCP server for Shiori bookmark management and tag workflows.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars12 downloads/wk

Reviews

Write one

Nobody has reviewed Shiori MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Shiori MCP tools (13, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • shiori_add_bookmark

    Add a bookmark to Shiori.

  • shiori_delete_bookmarkwrite action

    Delete one Shiori bookmark by id.

  • shiori_delete_bookmarkswrite action

    Delete one or more Shiori bookmarks by id.

  • shiori_get_bookmark

    Get one Shiori bookmark by id from the bookmark list.

  • shiori_get_bookmark_by_url

    Get one Shiori bookmark by exact URL from the bookmark list.

  • shiori_health_check

    Verify Shiori API connectivity and authentication with a small read-only request.

  • shiori_list_accounts

    List Shiori user accounts visible to the authenticated session.

  • shiori_list_bookmarks

    List Shiori bookmarks from the default Shiori bookmarks endpoint.

  • shiori_list_tags

    List Shiori tags and bookmark counts.

  • shiori_rename_tag

    Rename a Shiori tag.

  • shiori_search_bookmarks

    Search Shiori bookmarks client-side by text and/or tag.

  • shiori_update_bookmarkwrite action

    Update a Shiori bookmark using the full bookmark JSON object expected by the legacy API.

  • shiori_update_bookmark_fieldswrite action

    Patch common bookmark fields by fetching the current bookmark, modifying it, then sending Shiori's full update payload.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 120 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Shiori MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
13
the typical server has 7
Tools that change things
31%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
12
more than 3% of 12,191 servers with a package

What its tools let an agent do: 9 read · 4 change

Install Shiori MCP in Claude Code, Cursor or VS Code

claude mcp add shiori-mcp -- uvx shiori-mcp
Add to Cursor

What the publisher says

From the Shiori MCP repository's README, as published. We do not edit it. Read it on GitHub

Shiori MCP

<!-- mcp-name: io.github.rusty4444/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

MCP client config

{
  "mcpServers": {
    "shiori": {
      "command": "shiori-mcp",
      "env": {
        "SHIORI_BASE_URL": "https://shiori.example.com",
        "SHIORI_USERNAME": "your-username",
        "SHIORI_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Development and validation

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e '.[dev]'
ruff check .
pytest
python scripts/live_docs_test.py

livedocstest.py validates Shiori public API documentation and repository pages without credentials. Authenticated read/write API behaviours are covered with mocked HTTP tests.

Optional LLM validation can be run with any configured OpenAI-compatible endpoint. For local Aeon validation, set AEONBASEURL and optionally AEONMODEL / AEONAPIKEY before running python scripts/modelvalidate.py.

API note

This server targets Shiori's documented legacy API under /api/* because the new API v1 is still documented as in development and self-documented at /swagger/index.html on running instances.

Safety

The write-capable tools mutate a Shiori bookmark database. Keep credentials in environment variables or a secret manager, never in source control.

This project was developed with the assistance of AI tools.

Nothing above is checked by us. What we check is on the safety report.

Shiori MCP: common questions

Is Shiori MCP server safe?
Mostly: it is graded B (72/100). Read the Shiori MCP safety report
How do I install Shiori MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Shiori MCP need an API key?
Yes. The registry entry asks for SHIORI_SESSION_ID, SHIORI_PASSWORD.
Is Shiori MCP maintained?
The last commit was 157 days ago (2026-05-31). The latest release is v0.1.0.
How does Shiori MCP compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 13 (the typical server has 7); tools that change things 31% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from rusty4444 →