Readwise logo

Readwise

Organization
readwiseio

Readwise MCP

Publisherreadwiseio
Repositoryreadwise-mcp
LanguageJavaScript
Forks
11
Stars
148
Available tools
0
Transport typestdio
Categories
LicenseMIT
Links
  • Connect tools to AI workflows

    Readwise exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 0 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    148 stars and 11 forks from the linked repository.

Readwise MCP (Deprecated)

This MCP server is deprecated. Please use the new Readwise MCP server instead: readwise.io/mcp

The new server is hosted — no local installation needed. It supports both Readwise and Reader data, and works with Claude Desktop, ChatGPT, Claude Code, Cursor, and any MCP-compatible app.


Migration

Replace your existing claude_desktop_config.json entry with the new server. Setup instructions for all clients are at readwise.io/mcp.

If you also want CLI access and agent skills, see readwise.io/cli.


Legacy Installation (not recommended)

Installation in Claude

  1. Please make sure you have Node installed.
  2. Open Claude desktop app.
  3. Navigate to Settings > Developer.
  4. Click Edit Config.
  5. Add the following entry to the claude_desktop_config.json file, replacing ACCESS_TOKEN value with your Readwise Access Token.
{
  "mcpServers": {
    "Readwise MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@readwise/readwise-mcp"
      ],
      "env": {
        "ACCESS_TOKEN": "XXXXXXXXX"
      }
    }
  }
}

Troubleshooting

For general troubleshooting guidance, please refer to the official Model Context Protocol Claude Desktop Troubleshooting section.

"Could not attach to MCP server Readwise MCP"

A very likely reason for this to happen is that you have an incorrect npx/Node version set up. If you're using nvm, try running nvm use 18 in your terminal. If not, consider reinstalling Node.

Errors when calling Readwise tools

When using this MCP server, you may occasionally encounter MCP errors during your conversations with Claude. If you experience such errors, we recommend trying to switch between different Claude models (e.g., from Claude 3.5 Haiku to Claude 3.7 Sonnet) as this often resolves the issue.

Installation

TypingMind
Prerequisites:

Node.js 18+

{
  "mcpServers": {
    "Readwise MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@readwise/readwise-mcp"
      ],
      "env": {
        "ACCESS_TOKEN": "XXXXXXXXX"
      }
    }
  }
}

Use Readwise MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once Readwise is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add Readwise as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the Readwise MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "readwise": {
      "command": "npx",
      "args": [
        "-y",
        "@readwise/readwise-mcp"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the Readwise MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the Readwise MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use Readwise to help me with this task?
Readwise
Sure. I read it.
Here is what I found using Readwise.

Frequently asked questions

What is the Readwise MCP server used for?

Readwise is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use Readwise MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use Readwise with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use Readwise MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With Readwise connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect Readwise MCP to TypingMind?

Readwise runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does Readwise MCP provide in TypingMind?

Readwise exposes MCP capabilities that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use Readwise MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If Readwise requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇