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-05-01): ChatGPT (Custom GPT) and Claude (Custom Connectors) are end-to-end verified by the maintainer on all their supported platforms — web, desktop (macOS/Windows), iOS, and Android. Both require a paid plan (ChatGPT Plus/Team/Enterprise/Pro; Claude Pro/Max/Team/Enterprise). 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

Use the official Newsmind Custom GPT in ChatGPT — no setup required. Requires a paid ChatGPT account (Plus/Team/Enterprise/Pro).

Open Newsmind in ChatGPT →

Available on: ChatGPT web, macOS, Windows, iOS, and Android. The same Custom GPT works in every client — open the link above on any device, sign in once, and you're connected everywhere.

The first time you use it, ChatGPT will prompt you to sign in to Newsmind. Once authorized, you can ask things like "brief me on what's new today", "compare what my feeds are saying about the EU AI Act", or "add Hacker News to my feeds."

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.

Sign in at claude.ai
Click your avatar (top right) → Settings → Connectors
Click Add custom connector
Name: Newsmind
Remote MCP server URL: https://newsmind.app/mcp
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).
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.

Claude Desktop

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

Same OAuth flow as Claude.ai.

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

Any MCP-compatible client

For clients not listed above (Cursor, Gemini CLI, Cline, Zed, Continue, etc.), here's everything you need:

Endpoint: https://newsmind.app/mcp
Transport: Streamable HTTP / Server-Sent Events. The server also exposes a REST adapter at /api/v1/* for OpenAPI-aware clients.
Auth: OAuth 2.1 with PKCE and dynamic client registration (RFC 7591) — clients with native OAuth-MCP support discover endpoints from /.well-known/oauth-protected-resource. For everything else, pass a personal access token as Authorization: Bearer nm_...; generate one on the tokens page.

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.

Capability	What 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 / export	Migrate 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 reading	Mark 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.