Vinkius
Readwise logo
Vinkius
Vinkius runs on Vercel AI SDK

How to Use the Readwise MCP in Vercel AI SDK

Stream your Readwise data directly into your Vercel AI SDK interface for real-time knowledge retrieval and note management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Readwise MCP on Cursor AI Code Editor MCP Client Readwise MCP on Claude Desktop App MCP Integration Readwise MCP on OpenAI Agents SDK MCP Compatible Readwise MCP on Visual Studio Code MCP Extension Client Readwise MCP on GitHub Copilot AI Agent MCP Integration Readwise MCP on Google Gemini AI MCP Integration Readwise MCP on Lovable AI Development MCP Client Readwise MCP on Mistral AI Agents MCP Compatible Readwise MCP on Amazon AWS Bedrock MCP Support
MCP Servers — Included with Plan
Vinkius runs on Vercel AI SDK

Connect Readwise MCP to Vercel AI SDK

Create your Vinkius account to connect Readwise to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Key Capabilities

Real-time highlight retrieval

Feed your library directly into your UI by calling `list_highlights` through your streamText pipeline. Your users see their saved content populate the screen instantly as the agent fetches it. Stop waiting for batch processing. Because this MCP server talks to the Vercel AI SDK, every result flows straight into your React components without extra state management.

Dynamic book management

Use `list_books` or `search_books` to let your agent organize or filter your collection on the fly. It pushes structured data into your frontend, letting you build custom dashboards that update while the agent thinks. This keeps your application logic clean. Your agent handles the data discovery, and your UI handles the display, creating a tight loop between your knowledge base and your interface.

Interactive note creation

Trigger `create_highlight` or `update_highlight` directly from your chat input. The agent processes natural language requests and mirrors them to your Readwise account. It removes the friction of switching tabs. Your users stay in your app while the agent performs the heavy lifting, ensuring your notes stay current.

Setup guide

Set up Readwise MCP in Vercel AI SDK

Prerequisites

  • Node.js 18+ and a TypeScript project
  • ai + @modelcontextprotocol/sdk packages
  • Active Vinkius subscription with a valid endpoint token
  1. 1

    Install dependencies

    Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).

  2. 2

    Create the Streamable HTTP transport

    Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

  3. 3

    Discover and use tools

    Call mcpClient.tools() to auto-discover all Readwise tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.

  4. 4

    Works with any model provider

    Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts
import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Readwise transactions",
});

console.log(text);
await mcpClient.close();

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Readwise. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Readwise MCP in Vercel AI SDK

You connect the server as a tool provider within your generateText or streamText calls. The SDK executes the requested function and returns the raw data back to your application logic for rendering.
Yes. You can chain `get_book` with your LLM prompts to pull full text content. The agent then synthesizes that data into a summary for your user.
Absolutely. You can pass arguments like updatedAfter to `export_highlights` to limit the scope of data pulled into your session. This keeps your token usage predictable.
You call `list_tags` to see your current structure. From there, you can pass those tags to your agent to sort or categorize new highlights programmatically.
Your API token is handled by our managed environment. We only touch your highlights, books, and tag metadata, ensuring no sensitive account settings are exposed to the agent.

Start using the Readwise MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Built & Managed by Vinkius 30s setup 16 tools

We've already built the connector for Readwise. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 16 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.