monoread

yukukotani/monoread

3.4

If you are the rightful owner of monoread and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Monoread is a tool designed to provide high-quality content extraction from web pages, optimized for specific providers and integrated with Model Context Protocol servers.

Tools
1
Resources
0
Prompts
0

monoread

NPM Version

Gives your LLM the context of web pages in the smartest way.

Features

  • High-Quality Content Extraction: Powered by @mizchi/readability (Mozilla Readability) and llms.txt standards for reliable extraction from any web content
  • Provider-Specific Optimization: Specialized content extraction tailored for some providers such as GitHub
  • MCP Server Integration: Seamlessly integrates as a Model Context Protocol server, enabling AI assistants to fetch and process web content intelligently

Usage

CLI Usage

# You can read any url
npx monoread read https://example.com/article
npx monoread read https://github.com/yukukotani/monoread/blob/main/README.md
npx monoread read https://notion.so/your-page-id

MCP Usage

Add to Claude Code:

# Add to user scope (available across all projects)
claude mcp add monoread -s user -- npx -y monoread@latest mcp

# Or add to project scope to share with your team
claude mcp add monoread -s project -- npx -y monoread@latest mcp

# Also you can configure environment variables described below.
claude mcp add monoread -s user -e NOTION_API_KEY=your-integration-token -- npx -y monoread@latest mcp

Then add something like this to your CLAUDE.md:

Use `mcp__monoread__read_url_content` tool instead of builtin Fetch tool to read web pages.

Library Usage

import { monoread } from 'monoread';

// Basic usage
const result = await monoread('https://example.com/article');
if (result.success) {
  console.log(result.content);
  console.log(result.title);
  console.log(result.url);
}

// For Notion pages, set NOTION_API_KEY environment variable
process.env.NOTION_API_KEY = 'your-integration-token';
const notionResult = await monoread('https://notion.so/your-page-id');

Providers

monoread has special supports for some providers:

GitHub

No requirements.

monoread read https://github.com/owner/repo/blob/main/README.md

Notion

Requires setting up the NOTION_API_KEY environment variable:

  1. Create a Notion integration at https://www.notion.so/my-integrations
  2. Copy the Internal Integration Token
  3. Share your Notion pages with the integration:
    • Open the page in Notion
    • Click "Share" → "Add people, emails, or integrations"
    • Select your integration
  4. Set the environment variable: 
    export NOTION_API_KEY="your-integration-token"
monoread read https://notion.so/your-page-id

Other Providers

monoread attempts to extract content using @mizchi/readability or llms.txt.

Feel free to open pull requests or issues to add more specific provider supports.

License

Apache License 2.0

Contributing

See for development setup and guidelines.