MCP server for Shiori bookmark management and tag workflows.
Connect Runs on your machine
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
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
SHIORI_BASE_URLRequired | Base URL of the Shiori instance, e.g. https://shiori.example.com |
SHIORI_SESSION_IDOptional, secret | Existing Shiori session id; skips login if provided |
SHIORI_USERNAMEOptional | Shiori username; required unless SHIORI_SESSION_ID is set |
SHIORI_PASSWORDOptional, secret | Shiori password; required unless SHIORI_SESSION_ID is set |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 18 May 2026 |
| Last updated | 18 May 2026 |
| Registry name | io.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.
