Gemini Readwise Extension

Integrate your Readwise highlights and reading history directly into the Gemini CLI. This extension leverages the Model Context Protocol (MCP) and a specialized AI Librarian to help you search, synthesize, and discover insights from your personal knowledge base.

Features

• Semantic Search: Go beyond keywords with vector-based search to find conceptually related ideas.
• Expert Librarian Skill: A specialized agent persona (expert-librarian) trained to act as your reference librarian, connecting dots across your reading history.
• Advanced Filtering: Quickly pinpoint highlights by author, book title, or specific tags.
• Seamless Integration: Native slash commands that work anywhere in your Gemini CLI session.

Prerequisites

• Gemini CLI installed.
• A Readwise account with an active Access Token.

Configuration

Set your Readwise access token as an environment variable in your shell configuration (e.g., .bashrc, .zshrc, or .envrc):

export READWISE_TOKEN="your_token_here"

Installation

Install the extension directly via the Gemini CLI:

gemini extensions install https://github.com/thoreinstein/readwise

Alternatively, for local development:

git clone https://github.com/thoreinstein/readwise.git
cd readwise
gemini extensions link .

Usage

Skill: Expert Librarian

Activate the skill to enter a high-context mode for knowledge management. The Librarian understands how to use semantic search to synthesize information across your entire library.

/skill expert-librarian

Example Queries:

• "Summarize my recent reading on software architecture."
• "What are the common themes between my highlights on habit formation and productivity?"
• "Find the specific highlight where I read about 'second brains'."

Slash Commands

Quickly access your data with these built-in commands:

Command	Description
/readwise:books	List your 10 most recent books and articles.
/readwise:search <query>	Perform a semantic search for a specific term or concept.
/readwise:insights <query>	Search for conceptually "near" ideas to surface new connections.
/readwise:author <name>	Search highlights from a specific author.
/readwise:book <title>	Search highlights within a specific book or article.
/readwise:tag <tag>	Filter highlights by a specific tag.
/readwise:daily	Surface a random set of highlights for inspiration and review.

Development

This extension wraps the @readwise/readwise-mcp server.

License

ISC License. See LICENSE (if provided) or package.json for details.