FeedNest

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

1. 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.
2. 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)

1. Go to Settings → Apps & Connectors → Advanced and enable Developer Mode
2. Go to Settings → Apps → Create. Name it FeedNest and set the URL to https://mcp.feednest.com
3. 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.

1. Open claude.ai/directory/feednest, or search for FeedNest in Customize → Connectors
2. 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.

1. Go to Sidebar → Intelligence → Connectors
2. Click + Add Connector → Custom MCP Connector
3. Set Name to FeedNest, Server URL to https://mcp.feednest.com
4. 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"
      ]
    }
  }
}

---

Tools (25)

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.

Package	npm	Description
@feednest/sdk		TypeScript SDK — typed HTTP client for the FeedNest API v1
@feednest/openclaw		OpenClaw plugin — 26 agent tools for AI assistants
Codex plugin	—	OpenAI Codex plugin — skills + MCP config for Codex agents
@feednest/shared-tool-defs	private	Shared Zod schemas and text formatters (bundled into the plugin)

Development

npm install
npm run build    # Build all packages (sdk → shared-tool-defs → openclaw-plugin)
npm test         # Run all tests
npm run type-check

---

Links

• FeedNest - the app
• Documentation - full docs with setup guides per platform
• Integrations - see all AI integrations

License

MIT