MCP.so
Sign In

Unread MCP Server

@trieloff

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

trieloff

About Unread MCP Server

MCP server for searching Unread RSS reader database

Unread MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Unread MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unread MCP Server?

A read-only Model Context Protocol (MCP) server for performing keyword-based fulltext searches across articles stored in the Unread RSS reader app.

How to use Unread MCP Server?

Install by cloning the repository to ~/Developer/unread-mcp/ and making unread-mcp.sh executable. Then add the server to your Claude Desktop configuration (claude_desktop_config.json) with the command pointing to that script. Once configured, use Claude to call tools such as search-articles, get-article, get-stats, list-feeds, and search-by-feed.

Key features of Unread MCP Server

  • Keyword-based fulltext search (not semantic/vector)
  • Search across titles, content, authors, and feed names
  • Filter by article status: starred, read, unread
  • Boolean operators (AND, OR, NOT) and exact phrase search
  • Retrieve full article text and database statistics
  • List all RSS feeds with article counts

Use cases of Unread MCP Server

  • Search starred articles for specific topics using Boolean logic
  • Find unread articles about a subject, excluding certain keywords
  • Retrieve the full text of a specific article by its ID
  • View database statistics and list feeds with article counts

Frequently asked questions

1

Is the server read-only?

Yes, the server is strictly read-only and cannot modify your database.

2

Does it use semantic/vector search?

No, search is keyword-based, not semantic. Use specific terms rather than concepts.

3

Where does the data live?

The database path is hardcoded to the default Unread database location. The server only reads from that local database.

4

What dependencies are required?

The server requires `bash`, `sqlite3`, and `jq`. All are standard on macOS.

5

How can I debug issues?

Check the `requests.log` file in the same directory as the script for debugging information.

Comments

More Other MCP servers