PluginBench
MCP Server

Shiori MCP MCP Server

io.github.rusty4444/shiori-mcp

What is the Shiori MCP MCP server?

MCP server for Shiori bookmark management and tag workflows.

How to install Shiori MCP

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SHIORI_BASE_URL
    required

    Base URL of the Shiori instance, e.g. https://shiori.example.com

  • SHIORI_SESSION_ID
    secret

    Existing Shiori session id; skips login if provided

  • SHIORI_USERNAME

    Shiori username; required unless SHIORI_SESSION_ID is set

  • SHIORI_PASSWORD
    secret

    Shiori password; required unless SHIORI_SESSION_ID is set

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "shiori-mcp": {
      "command": "uvx",
      "args": [
        "shiori-mcp"
      ],
      "env": {
        "SHIORI_BASE_URL": "<YOUR_SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<YOUR_SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<YOUR_SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<YOUR_SHIORI_PASSWORD>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "shiori-mcp": {
      "command": "uvx",
      "args": [
        "shiori-mcp"
      ],
      "env": {
        "SHIORI_BASE_URL": "<YOUR_SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<YOUR_SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<YOUR_SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<YOUR_SHIORI_PASSWORD>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "shiori-mcp": {
      "command": "uvx",
      "args": [
        "shiori-mcp"
      ],
      "env": {
        "SHIORI_BASE_URL": "<YOUR_SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<YOUR_SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<YOUR_SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<YOUR_SHIORI_PASSWORD>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "shiori-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shiori-mcp"
      ],
      "env": {
        "SHIORI_BASE_URL": "<YOUR_SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<YOUR_SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<YOUR_SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<YOUR_SHIORI_PASSWORD>"
      }
    }
  }
}
Claude Code
claude mcp add shiori-mcp --env SHIORI_BASE_URL=<YOUR_SHIORI_BASE_URL> --env SHIORI_SESSION_ID=<YOUR_SHIORI_SESSION_ID> --env SHIORI_USERNAME=<YOUR_SHIORI_USERNAME> --env SHIORI_PASSWORD=<YOUR_SHIORI_PASSWORD> -- uvx shiori-mcp

Related MCP servers

MCP server for ChangeDetection.io website monitoring and change history.

View repository →

MCP server for Grocy household ERP inventory and shopping workflows.

View repository →

MCP server for wallabag read-it-later entries, tags, and annotations.

View repository →