Newsmind

Install Guide

Connect Newsmind to your AI assistant. Same hosted MCP server for every client — only the config syntax differs.

The basics

Server URL:

https://newsmind.app/mcp

Auth: OAuth 2.1 with PKCE and dynamic client registration (RFC 7591). For clients that don't yet speak OAuth, use a personal access token (Authorization: Bearer nm_…) generated from your Newsmind account.

Transport: HTTP/SSE (Streamable HTTP). The server also exposes a REST adapter at /api/v1/* for OpenAPI-aware clients (see ChatGPT).

Verification status (2026-08-20): ChatGPT, Claude and Gemini are end-to-end verified by the maintainer on all their supported platforms — web, desktop (macOS/Windows), iOS, and Android. All three require a paid plan (ChatGPT Plus/Team/Enterprise/Pro; Claude Pro/Max/Team/Enterprise; Gemini Spark requires Google AI Pro or Ultra on a personal Google Account). Other MCP-compatible clients work too but vary in their OAuth + remote-HTTP handling — see the generic-client section at the bottom. If your client doesn't complete OAuth cleanly, fall back to a personal access token — generate one on the tokens page and paste it as a Bearer header.

ChatGPT

Install the official Newsmind plugin from the ChatGPT plugin directory, then sign in once. Requires a paid ChatGPT account (Plus/Team/Enterprise/Pro).

Install Newsmind in ChatGPT →

  1. Open the link above and click Install plugin.
  2. Sign in to Newsmind when prompted — OAuth handles it. No API key to paste.
  3. In any chat, mention @Newsmind and ask — e.g. "@Newsmind what's new in my feeds today?"

Available on: ChatGPT web, macOS, Windows, iOS, and Android. Connect once and it follows you — sign in on each device and Newsmind is there, with no per-device setup.

The first time you use it, ChatGPT will prompt you to sign in to Newsmind. Once authorized, mention @Newsmind and ask things like "what's new in my feeds today?", "search my feeds for articles about artificial intelligence", or "add Hacker News to my feeds."

For what this looks like day to day — more example prompts, and what Newsmind can and can't do inside ChatGPT — see RSS for ChatGPT.

Build your own ChatGPT integration (advanced)

Newsmind ships an OpenAPI 3.1 spec for anyone building their own GPT or OpenAPI-aware client:

https://newsmind.app/api/v1/openapi.json

Use OAuth 2.1 (PKCE for public clients, client_secret for confidential clients). Email [email protected] to register a confidential client.

Claude.ai (Custom Connectors)

Plan required: Claude Pro, Max, Team, or Enterprise. Custom Connectors are not available on Claude's free plan.

  1. Sign in at claude.ai
  2. Click your avatar (top right) → Settings → Connectors
  3. Click Add custom connector
  4. Name: Newsmind
  5. Remote MCP server URL: https://newsmind.app/mcp
  6. Claude.ai runs OAuth: discovery → registration → sign-in form → token. You'll be prompted to sign in (or sign up if you don't have an account).
  7. Approve the scope. The connector flips to Connected.

Available on: claude.ai web (including mobile browsers) and the Claude apps for iOS and Android. Connectors set up on claude.ai sync to your mobile apps automatically — sign in once on each device and Newsmind shows up in the connector list.

Try it: open a new chat and ask "What feeds am I subscribed to in Newsmind?" — Claude will call the list_feeds tool and return your subscriptions.

For more on reading feeds inside Claude — example prompts, and how the same connector carries across web, desktop, and mobile — see RSS for Claude.

Claude Desktop

Plan required: Claude Pro, Max, Team, or Enterprise. Available on: macOS and Windows.

Same OAuth flow as Claude.ai.

  1. Settings → Connectors (or Developer → MCP, depending on version)
  2. Name: Newsmind
  3. Remote MCP server URL: https://newsmind.app/mcp
  4. Complete the OAuth flow in the browser window that opens

Gemini (Spark)

Plan required: Google AI Pro or Ultra, on a personal Google Account — Spark is where custom apps run. Available on: web and mobile.

  1. Settings → Personal Intelligence → Connected Apps
  2. Choose Custom apps, and under “Custom apps for Spark” paste https://newsmind.app/mcp
  3. Click Next and sign in once — OAuth handles it, no config file and no API key
  4. Switch to Spark and name Newsmind in the ask: “What's unread in my Newsmind feeds?”

Any MCP-compatible client

For clients not listed above (Cursor, Gemini CLI, Cline, Zed, Continue, etc.), here's everything you need. For background on the server itself — transport, auth, and how it fits the MCP spec — see RSS MCP server.

Most clients accept a JSON config along these lines (substitute the keys your client uses — common ones are mcpServers, context_servers, modelContextProtocolServers):

{
  "mcpServers": {
    "newsmind": {
      "url": "https://newsmind.app/mcp",
      "headers": {
        "Authorization": "Bearer nm_YOUR_TOKEN_HERE"
      }
    }
  }
}

If something doesn't work, the most common cause is that your client doesn't yet speak streamable-HTTP MCP or its OAuth handling is incomplete — try the bearer-token path (above) before falling back to a different client.

What you can ask your AI to do

Once connected, your AI handles RSS through natural conversation. You don't need to know any tool names — just ask in plain language.

CapabilityWhat you can ask
Read your feeds"What's new today?", "Show me unread from MacRumors", "What landed in the last hour?"
Search by keyword"Find articles about Apple Vision Pro", "Show me anything mentioning the EU AI Act"
Search by meaning (Max)"Find articles about AI chip supply" — semantic search across your feeds, finds matches that don't share keywords
Pick up where you left off"What's new since I last asked?" — works across separate conversations; the server tracks the cursor for you
Manage your subscriptions"Subscribe to Six Colors", "Unsubscribe from that newsletter", "Move all Apple feeds into a folder"
Bulk import / exportMigrate in or out using standard OPML — works with Feedly, Inoreader, NetNewsWire, and any other reader. Up to 100 feeds at a time through your AI; larger files upload from the account page
Curate your readingMark articles read or unread, star favorites, review your reading history
Diagnose your feeds"Which feeds are dead?", "Show me feeds I should prune", "Find duplicate articles across my subscriptions"
Account & billing"What plan am I on?", "When does my trial end?", "How close am I to my feed limit?"

Discovery and search respect your plan's retention window — 30 days on Pro, 90 days on Max. Articles you've already saved (starred or marked read) remain accessible by ID even after they age out.

Troubleshooting

OAuth flow fails / "Couldn't send tool approval" — usually transient on the client side. Reload the client and retry. If it persists, disconnect and reconnect the connector.

Bearer token returns 401 — your token may have been rotated. Generate a fresh one from your Newsmind account.

Bearer token returns 402 — your trial has expired or your subscription lapsed. Manage your subscription.

Tools don't show up after configuring — your client may not yet support remote HTTP MCP servers with the auth flow you're using. Email [email protected] with your client name and version.

Last updated: April 30, 2026 · Questions: [email protected]