MCP Server

Overview

Shiori's MCP server lets AI coding assistants and other tools access your saved links. It supports the standard Model Context Protocol with OAuth authentication — just add the server URL and your tool handles the rest.

Getting started

Add this server URL to your MCP client:

https://www.shiori.sh/mcp

Most MCP clients support "remote" or "URL-based" servers. Add the URL above, and the client will handle OAuth authentication automatically — you'll be prompted to authorize through your browser the first time you connect.

App setup

Claude Code

Run this command in your terminal:

claude mcp add shiori --transport http https://www.shiori.sh/mcp

Then restart Claude Code. You'll be prompted to authorize through your browser on first use.

Claude Desktop

Go to Settings → Integrations → Add MCP Server. Enter the URL https://www.shiori.sh/mcp and follow the OAuth prompts.

Cursor

Go to Cursor Settings → MCP → Add new MCP Server. Set the type to "URL" and enter https://www.shiori.sh/mcp.

Windsurf

Follow Windsurf's MCP configuration guide. Add a new server with URL https://www.shiori.sh/mcp.

Codex

Run this command in your terminal:

codex mcp add shiori --url https://www.shiori.sh/mcp

VS Code / Copilot

Add to your MCP settings (.vscode/mcp.json or user settings):

{
  "servers": {
    "shiori": {
      "type": "http",
      "url": "https://www.shiori.sh/mcp"
    }
  }
}

ChatGPT

Go to Settings → Connectors → Add Connector. Enter the URL https://www.shiori.sh/mcp, give it a name, and save. Then start a new conversation, click More → Add Connectors, and select Shiori. You'll be prompted to authorize on first use.

Other MCP clients

Any MCP client that supports remote/HTTP servers can connect. Use the server URL https://www.shiori.sh/mcp. The client will discover the OAuth configuration automatically via the .well-known/oauth-authorization-server metadata endpoint.

Available tools