NestDaddy

Shiori MCP

io.github.rusty4444/shiori-mcp · v0.1.0

MCP server for Shiori bookmark management and tag workflows.

Connect Runs on your machine

Terminal
claude mcp add shiori-mcp -e SHIORI_BASE_URL=<SHIORI_BASE_URL> -e SHIORI_SESSION_ID=<SHIORI_SESSION_ID> -e SHIORI_USERNAME=<SHIORI_USERNAME> -e SHIORI_PASSWORD=<SHIORI_PASSWORD> -- uvx shiori-mcp==0.1.0
claude_desktop_config.json
{
  "mcpServers": {
    "shiori-mcp": {
      "command": "uvx",
      "args": [
        "shiori-mcp==0.1.0"
      ],
      "env": {
        "SHIORI_BASE_URL": "<SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<SHIORI_PASSWORD>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "shiori-mcp": {
      "command": "uvx",
      "args": [
        "shiori-mcp==0.1.0"
      ],
      "env": {
        "SHIORI_BASE_URL": "<SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<SHIORI_PASSWORD>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "shiori-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shiori-mcp==0.1.0"
      ],
      "env": {
        "SHIORI_BASE_URL": "<SHIORI_BASE_URL>",
        "SHIORI_SESSION_ID": "<SHIORI_SESSION_ID>",
        "SHIORI_USERNAME": "<SHIORI_USERNAME>",
        "SHIORI_PASSWORD": "<SHIORI_PASSWORD>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
SHIORI_BASE_URL
Required
Base URL of the Shiori instance, e.g. https://shiori.example.com
SHIORI_SESSION_ID
Optional, secret
Existing Shiori session id; skips login if provided
SHIORI_USERNAME
Optional
Shiori username; required unless SHIORI_SESSION_ID is set
SHIORI_PASSWORD
Optional, secret
Shiori password; required unless SHIORI_SESSION_ID is set

Details

Package[email protected] (PYPI, stdio)
First published18 May 2026
Last updated18 May 2026
Registry nameio.github.rusty4444/shiori-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.