FeedNest MCP Server
Your sources. Not the whole web. Ask your AI about your feeds - it already knows.
ChatGPT searches the internet. Perplexity crawls billions of pages. When you ask about your industry, your interests, your world - they give you everything except what matters.
FeedNest is different. Your AI works exclusively with the sources you choose: the blogs you trust, the publications you follow, the experts you believe in. No algorithmic noise. No black-box results. Intelligence grounded in your world.
This MCP server gives any AI assistant - ChatGPT, Codex, Claude, Gemini, Grok, Cursor, Windsurf, Cline, Le Chat, and more - direct access to your feeds, articles, highlights, notes, and tags through natural language.
What Your AI Can Do
Just ask. Your AI handles the rest.
- Morning briefings - Wake up to a summary of everything that happened overnight across your feeds
- Compare coverage - See how different sources report the same story, side by side
- Spot trends early - Your AI detects emerging patterns before they hit mainstream
- Deep-dive any topic - Get a comprehensive synthesis from every source you follow
- Track developing stories - Follow a narrative as it evolves across all your feeds
- Instant search - Find any article across all your sources in seconds
- Highlights and notes - Save what matters and annotate with your own thoughts
Quick Start
Prerequisites
- A FeedNest account. Apps that connect with OAuth (ChatGPT, Claude) work on every plan: on Free they can read your feeds and articles, up to 20 requests an hour; Plus and Pro also let them save, tag, highlight, take notes and mark articles as read.
- For clients set up with an API key: a key from Settings → Developer API, which needs a Pro subscription
ChatGPT
Option A: Web UI (OAuth - recommended)
- Go to Settings → Apps & Connectors → Advanced and enable Developer Mode
- Go to Settings → Apps → Create. Name it FeedNest and set the URL to
https://mcp.feednest.com
- ChatGPT will redirect you to FeedNest - log in and authorize
No API key needed. ChatGPT handles the OAuth flow automatically.
Option B: Responses API
Include FeedNest as an MCP tool in your API request:
{
"type": "mcp",
"server_url": "https://mcp.feednest.com",
"server_label": "feednest",
"authorization": "fn_live_YOUR_API_KEY"
}
Codex
Option A: Plugin (recommended)
The plugin bundles skills, MCP config, and brand assets in one install. It is not in the Codex plugin directory yet, so install it from this repository: see Local Installation in the Codex plugin README.
Option B: MCP in config.toml
Add to ~/.codex/config.toml:
[mcp_servers.feednest]
url = "https://mcp.feednest.com"
bearer_token_env_var = "FEEDNEST_API_KEY"
export FEEDNEST_API_KEY="fn_live_YOUR_API_KEY"
Or via CLI:
codex mcp add feednest --transport http https://mcp.feednest.com
Claude
Connectors directory (OAuth - recommended)
FeedNest is listed in Claude's connectors directory.
- Open claude.ai/directory/feednest, or search for FeedNest in Customize → Connectors
- Click Connect to Claude, log in to FeedNest, and authorize
No API key needed, and the connector follows your Claude account to Claude Desktop and the mobile apps.
To add it by URL instead, add a custom connector in Customize → Connectors with the URL https://mcp.feednest.com and leave OAuth Client ID and Secret empty.
Claude Code
claude mcp add --transport http feednest https://mcp.feednest.com \
--header "Authorization: Bearer fn_live_YOUR_API_KEY"
Add -s user for global access across all projects.
Claude Desktop config file (requires bridge)
The directory connector above already works in Claude Desktop. To configure FeedNest in claude_desktop_config.json instead, which only runs stdio servers, use the mcp-remote bridge:
{
"mcpServers": {
"feednest": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.feednest.com",
"--header", "Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Config path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows), or ~/.config/Claude/claude_desktop_config.json (Linux).
Cursor
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):
{
"mcpServers": {
"feednest": {
"url": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Tip: Cursor supports env var interpolation: "Bearer ${env:FEEDNEST_API_KEY}". Do not add a "type" field - Cursor auto-detects from the "url" key.
Le Chat (Mistral)
Available on all plans, including the free tier.
- Go to Sidebar → Intelligence → Connectors
- Click + Add Connector → Custom MCP Connector
- Set Name to
FeedNest, Server URL to https://mcp.feednest.com
- Set Auth type to
API Token Authentication, Authorization to Bearer fn_live_YOUR_API_KEY
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"feednest": {
"serverUrl": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Important: Windsurf uses "serverUrl" (not "url"). Using the wrong key causes a silent failure.
Cline
In VS Code, open Cline extension settings → MCP Servers configuration (JSON):
{
"mcpServers": {
"feednest": {
"type": "streamableHttp",
"url": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Critical: The "type": "streamableHttp" field is mandatory for Cline. Without it, custom headers may fail silently and authentication won't work.
Gemini CLI
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"feednest": {
"httpUrl": "https://mcp.feednest.com",
"headers": {
"Authorization": "Bearer fn_live_YOUR_API_KEY"
}
}
}
}
Note: Gemini CLI uses "httpUrl" (not "url"). The "url" field is reserved for SSE transport. CLI only - gemini.google.com does not support external MCP servers.
Grok (xAI)
Available through the xAI API/SDK only, not from the grok.com chat UI.
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-3",
"tools": [{
"type": "mcp",
"server_url": "https://mcp.feednest.com",
"server_label": "feednest",
"authorization": "Bearer fn_live_YOUR_API_KEY"
}],
"input": "What are my unread articles?"
}'
Any other MCP client
Any client supporting Streamable HTTP can connect using:
- URL:
https://mcp.feednest.com
- Header:
Authorization: Bearer fn_live_YOUR_API_KEY
For stdio-only clients, use the mcp-remote bridge:
{
"mcpServers": {
"feednest": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.feednest.com",
"--header", "Authorization:Bearer fn_live_YOUR_API_KEY"
]
}
}
}
Articles
| Tool | Description | Key Parameters |
|---|
get_articles | List articles with title, source, date, and summary preview. Views: newsfeed, by-feed, by-folder, by-tag, tagged, highlighted, noted. | view*, feed_id, folder_id, tag_id, limit, query, sort, unread_only, date_from, date_to, count_only |
get_article | Get full article content including highlights, notes, and reading time. | article_id* |
extract_article | Fetch full content from the original URL when RSS truncated it. | article_id* |
Read Status
| Tool | Description | Key Parameters |
|---|
mark_as_read | Mark an article as read. | article_id* |
mark_as_unread | Mark an article as unread. | article_id* |
mark_all_as_read | Mark all articles as read, optionally filtered by feed or folder. | feed_id, folder_id |
Saving
| Tool | Description | Key Parameters |
|---|
save_article | Save an article for later reading. | article_id* |
unsave_article | Remove an article from saved items. | article_id* |
save_url | Save an external URL for later reading. | url* |
get_saved | List saved articles with search, date filtering, and sorting. | limit, query, sort, date_from, date_to |
Feeds & Structure
| Tool | Description | Key Parameters |
|---|
get_feeds | List subscribed feeds with unread counts. Search by name. | folder_id, query, limit |
get_folders | List all feed folders with feed counts. | - |
get_tags | List all tags with article counts. | - |
Tagging
| Tool | Description | Key Parameters |
|---|
create_tag | Create a new tag for categorizing articles. | name*, color |
delete_tag | Delete a tag by ID. | tag_id* |
tag_article | Add or remove a tag on an article. | article_id*, tag_id*, action* (add/remove) |
Highlights
| Tool | Description | Key Parameters |
|---|
get_highlights | Get all text highlights from an article. | article_id* |
add_highlight | Highlight a text passage. The text must exist exactly in the article. | article_id*, text*, color |
remove_highlight | Remove a highlight from an article. | article_id*, highlight_id* |
Notes
| Tool | Description | Key Parameters |
|---|
get_notes | Get the note on an article. | article_id* |
add_note | Add or update a note on an article. | article_id*, content* |
delete_note | Delete a note from an article. | article_id* |
History
| Tool | Description | Key Parameters |
|---|
get_recently_read | Get recently opened articles. Supports search and date filtering. | limit, since, date_to, query, sort |
Output Feeds
| Tool | Description | Key Parameters |
|---|
get_output_feeds | List public RSS output feeds created by the user. | - |
AI
text_to_speech is not exposed by the hosted MCP server: it generates audio with
an AI model, which the Claude connectors directory does not allow. Reading articles
aloud stays available in the FeedNest app and through the OpenClaw plugin.
Stats
| Tool | Description | Key Parameters |
|---|
get_stats | Reading streak, articles read today, reading time, total feeds, unread count, saved count. | - |
* = required parameter
Example Conversation
You: "What's happening in AI today?"
ChatGPT: "Based on your tech feeds, here are today's 3 biggest stories:
1. OpenAI announced GPT-5, covered first in your Hacker News feed
2. EU AI Act enforcement begins, mentioned across 4 of your sources
3. Google published new Gemini research, from your AI folder
Want me to summarize any of them?"
More things you can ask
- "Give me a morning briefing from my feeds"
- "Compare how Bloomberg and Reuters covered this story"
- "What did I read yesterday?"
- "Save this article and highlight the key findings"
- "Tag all AI-related articles with 'Machine Learning'"
- "How's my reading streak going?"
Authentication
API Key (personal use)
Generate a key from Settings → Developer API in the FeedNest dashboard. Keys start with fn_live_ followed by 32 hex characters.
Authorization: Bearer fn_live_abc123...
OAuth 2.1 (third-party apps)
The server supports full OAuth 2.1 with PKCE. Discovery endpoint:
https://mcp.feednest.com/.well-known/oauth-protected-resource
ChatGPT and Claude.ai handle OAuth automatically - no API key needed for those.
Plans
Apps that connect with OAuth work on every FeedNest plan. API keys need Pro.
| Free | Plus | Pro |
|---|
| Read feeds, folders, articles, saved articles, tags, reading history and output feeds | Yes | Yes | Yes |
| An article's highlights | Yes | Yes | Yes |
Notes, the highlighted and noted views, reading statistics | No | Yes | Yes |
| Changes: mark as read, save, tag, highlight, take notes, load an article's full text | No | Yes | Yes |
Date filters (date_from, date_to, since) | No | No | Yes |
| Requests an hour | 20 tool calls | 1,000 | 1,000 |
| API keys | No | No | Yes |
A connected app picks up a plan change at its next token refresh, within an hour, or right away when you reconnect FeedNest.
Scopes
| Scope | Access |
|---|
read | All read-only tools (get_articles, get_feeds, get_stats, etc.) |
write | All mutation tools (mark_as_read, save_article, add_highlight, etc.) |
ai | No MCP tool at the moment (see AI above) |
You Stay in Control
- You choose what's visible - Pick exactly which feeds, folders, and actions your AI can access
- Encrypted and verified - Every request is secured so no one else can reach your data
- Built-in usage limits - 1,000 requests an hour (20 tool calls on Free), so your account stays protected
- Revoke access instantly - One click from your dashboard
Troubleshooting
| Issue | Solution |
|---|
| "Bearer token required" | Check that the Authorization header is set correctly |
| "Invalid API key format" | Key must start with fn_live_ followed by 32 hex characters |
| "Invalid or revoked API key" | Regenerate from Settings → Developer API |
| "API access requires a Pro subscription" | API keys need Pro. Upgrade at feednest.com, or connect with OAuth, which works on every plan |
| "...included in FeedNest Plus and Pro" | The account is on the Free plan, where apps can read feeds, articles, saved articles, tags and highlights but not change anything. After upgrading, reconnect FeedNest so the app gets the new plan. See Plans |
| "Filtering by date is included in FeedNest Pro" | Date filters need Pro. Without them, articles still come newest first |
| "...includes 20 requests an hour from AI assistants" | The Free plan's hourly allowance is used up. Try again after the wait the message gives |
| "Rate limit reached" | Wait a few minutes and retry |
| "Insufficient scope" | Your API key doesn't have the required scope |
| Tools not appearing | Restart your AI client after changing MCP configuration |
Packages
This repository is a monorepo containing the client libraries and plugins for the FeedNest MCP server.
Development
npm install
npm run build
npm test
npm run type-check
Links
License
MIT
