Shiori MCP Server
by rusty4444io.github.rusty4444/shiori-mcpv0.1.0
MCP server for Shiori bookmark management and tag workflows.
context tax
queued
security
queued
cold start
queued
freshness
Slowing4mo ago
Install Shiori MCP server
Install in Claude Code
claude mcp add shiori -e SHIORI_BASE_URL='<shiori-base-url>' -e SHIORI_SESSION_ID='<shiori-session-id>' -e SHIORI_PASSWORD='<shiori-password>' -- uvx shiori-mcpInstall in Cursor
{
"mcpServers": {
"shiori": {
"command": "uvx",
"args": [
"shiori-mcp"
],
"env": {
"SHIORI_BASE_URL": "<shiori-base-url>",
"SHIORI_SESSION_ID": "<shiori-session-id>",
"SHIORI_PASSWORD": "<shiori-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"shiori": {
"command": "uvx",
"args": [
"shiori-mcp"
],
"env": {
"SHIORI_BASE_URL": "<shiori-base-url>",
"SHIORI_SESSION_ID": "<shiori-session-id>",
"SHIORI_PASSWORD": "<shiori-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"shiori": {
"type": "stdio",
"command": "uvx",
"args": [
"shiori-mcp"
],
"env": {
"SHIORI_BASE_URL": "<shiori-base-url>",
"SHIORI_SESSION_ID": "<shiori-session-id>",
"SHIORI_PASSWORD": "<shiori-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"shiori": {
"command": "uvx",
"args": [
"shiori-mcp"
],
"env": {
"SHIORI_BASE_URL": "<shiori-base-url>",
"SHIORI_SESSION_ID": "<shiori-session-id>",
"SHIORI_PASSWORD": "<shiori-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| SHIORI_BASE_URL | yes | — | Base URL of the Shiori instance, e.g. https://shiori.example.com |
| SHIORI_SESSION_ID | — | yes | Existing Shiori session id; skips login if provided |
| SHIORI_USERNAME | — | — | Shiori username; required unless SHIORI_SESSION_ID is set |
| SHIORI_PASSWORD | — | yes | Shiori password; required unless SHIORI_SESSION_ID is set |
Freshness
Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-05-31 · 4mo ago · GitHub
Latest release
2026-05-31 · 4mo ago · GitHub · v0.1.1
Package published
no data · npm/PyPI
Registry entry updated
2026-05-18 · 5mo ago · official registry · v0.1.0
FAQ
›How do I install the Shiori MCP server in Claude Code?
Run: claude mcp add shiori -e SHIORI_BASE_URL='<shiori-base-url>' -e SHIORI_SESSION_ID='<shiori-session-id>' -e SHIORI_PASSWORD='<shiori-password>' -- uvx shiori-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Shiori require an API key?
Yes. It expects SHIORI_BASE_URL, SHIORI_SESSION_ID, SHIORI_PASSWORD, of which 2 are secrets.
›Can I use Shiori as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Shiori in the official MCP registry?
Yes, as io.github.rusty4444/shiori-mcp.