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://api.newsmind.app/functions/v1/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).

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 →

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://api.newsmind.app/functions/v1/mcp/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)verified

1. Sign in at claude.ai
2. Click your avatar (top right) → Settings → Connectors
3. Click Add custom connector
4. URL: paste https://api.newsmind.app/functions/v1/mcp
5. 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).
6. Approve the scope. The connector flips to Connected.

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 Desktopverified

Same OAuth flow as Claude.ai.

1. Settings → Developer → MCP (or Custom Connectors, depending on version)
2. Add a new server with URL https://api.newsmind.app/functions/v1/mcp
3. Complete the OAuth flow in the browser window that opens

If your version only supports stdio MCP servers, see stdio bridge fallback.

Cursorverified

Cursor supports remote MCP servers, but its OAuth handling for newer flows is still maturing. Bearer-token is the safer path today.

Edit ~/.cursor/mcp.json (create it if missing):

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

Restart Cursor. If the server registers but tools don't show up, your version may not yet support remote HTTP MCP — use the stdio bridge fallback.

Cline (VS Code extension)unverified

In your VS Code settings.json:

{
  "cline.mcpServers": {
    "newsmind": {
      "type": "sse",
      "url": "https://api.newsmind.app/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer nm_YOUR_TOKEN_HERE"
      }
    }
  }
}

Reload the window after editing.

Zedunverified

Zed's "context servers" are MCP under the hood; HTTP support depends on your Zed version.

In Zed settings.json:

{
  "context_servers": {
    "newsmind": {
      "url": "https://api.newsmind.app/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer nm_YOUR_TOKEN_HERE"
      }
    }
  }
}

If your Zed only supports stdio context servers, use the stdio bridge fallback.

Continue.devunverified

In ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "sse",
          "url": "https://api.newsmind.app/functions/v1/mcp",
          "headers": {
            "Authorization": "Bearer nm_YOUR_TOKEN_HERE"
          }
        }
      }
    ]
  }
}

Stdio bridge fallback

For clients that only support stdio MCP servers (older versions of Cursor, Zed, Continue, etc.), an npx newsmind-mcp wrapper that proxies stdio ↔ remote HTTP is on the roadmap. Until it ships, use a client that supports remote HTTP MCP (Claude.ai is the easiest on-ramp).

Tools available

Once connected, your AI gets these 13 tools. You don't need to memorize them — Claude/etc. picks the right one based on what you ask.

Discovery tools (get_unread, search_articles, semantic_search, since_last_check, counts) only surface articles within your plan's retention window — 30 days on Pro, 90 days on Max. Starred articles bypass the window. Lookup tools (get_article, mark_read, star_articles) work on any article you have an ID for, regardless of age.

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]