mcp-readwise

FastMCP上に構築されたReadwise用MCPサーバー。ハイライト、書籍、タグ、Readerドキュメント、一括エクスポートを網羅する17個のツールを提供します。

インストール

uv sync

またはpipを使用する場合:

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

設定

以下の環境変数を設定してください:

変数	必須	デフォルト	説明
`READWISE_TOKEN`	はい	-	Readwise APIアクセストークン
`TRANSPORT`	いいえ	`stdio`	トランスポートモード: `stdio` または `http`
`HOST`	いいえ	`127.0.0.1`	HTTPサーバーホスト
`PORT`	いいえ	`8000`	HTTPサーバーポート
`MCP_API_KEY`	いいえ	-	MCPポータル認証用ベアラートークン
`READWISE_BASE_URL`	いいえ	`https://readwise.io`	Readwise APIベースURL

Readwiseアクセストークンの取得先: https://readwise.io/access_token

使用方法

ローカル (stdio)

READWISE_TOKEN=your_token uv run mcp-readwise

HTTPモード

READWISE_TOKEN=your_token TRANSPORT=http uv run mcp-readwise

Docker

cp .env.example .env  # Add your READWISE_TOKEN
docker compose up -d

利用可能なツール

ハイライト

ツール	説明
`search_highlights`	セマンティック、全文、またはハイブリッドモードを使用した検索
`list_highlights`	フィルター（書籍、タグ、日付）とページネーションによる一覧表示
`get_highlight`	IDによる取得（書籍メタデータ付き）
`create_highlight`	書籍への作成（オプションのメモ/タグ付き）
`update_highlight`	テキストまたはメモの更新
`delete_highlight`	IDによる削除
`export_highlights`	カーソルページネーションによる一括エクスポート

書籍

ツール	説明
`list_books`	カテゴリ/ソース/注釈フィルターによる一覧表示
`get_book`	IDによる取得

Reader

ツール	説明
`list_documents`	場所/カテゴリフィルターによるReaderドキュメントの一覧表示
`get_document`	IDによる取得（全文コンテンツ付き）
`save_url`	URLをReaderに保存
`update_progress`	読書進捗の更新 (0.0-1.0)

プロジェクト構造

mcp_readwise/
  server.py      # FastMCP app, tool registration, entry point
  config.py      # pydantic-settings configuration
  client.py      # Centralized httpx client (auth, retries, rate limits)
  auth.py        # Bearer token verifier for MCP Portal
  models/        # Pydantic response models
  tools/         # Tool functions by domain

デプロイ

Komodo経由で ubuntu-smurf-mirror にデプロイ済み。Cloudflare MCPポータル mcp-readwise.cdit-dev.de からアクセス可能。

ライセンス

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

ツール	説明
`list_tags`	すべてのタグの一覧表示
`create_tag`	新しいタグの作成
`delete_tag`	IDによる削除
`tag_highlight`	ハイライトへのタグの追加または削除

Readwise MCP HTTP Server