# Reddit MCP server and search API: connecting Reddit to Claude, Cursor and ChatGPT

You connect Reddit to Claude, Cursor or another AI assistant with a Reddit MCP server, which needs the client ID and secret of a Reddit API app, or by calling Reddit's search endpoint yourself with the same credentials. Reddit stopped accepting new requests for public API access on October 31, 2026, so both routes now work only if you already hold approved credentials, and Reddit says the remaining public API access ends in March 2027. Without credentials, the working route is a research tool that finds the threads for you: logged-out requests to Reddit's `.json` endpoints all returned HTTP 403 when we tested them on November 15, 2026.

Everything below was read from Reddit's help center, its Data API Terms and its API docs, and from each MCP server's repository, on November 15, 2026.

## Reddit API access in November 2026

Reddit is moving apps that use its public Data API onto its Developer Platform, and the dates are on Reddit's own pages. The [Changelog for October 8, 2026](https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026) says public Data API apps and bots "are moving to Reddit's Developer Platform as part of efforts to reduce scraping and automated abuse", and lists the timeline:

| Date | What Reddit says happens | Source |
|---|---|---|
| October 31, 2026 | "New requests for public API access will no longer be accepted." | Reddit Changelog, October 8, 2026 |
| November 13, 2026 | RSS feed support ends | Reddit Changelog, October 8, 2026 |
| November 30, 2026 | Last day to register an app and possibly qualify for a $1,000 porting bounty | developers.reddit.com/app-registration |
| January 12, 2027 | "API access removal begins for apps and users that haven't registered or responded to Reddit's outreach." | Reddit Changelog; app registration page |
| March 2027 | "Remaining public API access ends." | Reddit Changelog; app registration page |

If you already have a Reddit API app, register it at [developers.reddit.com/app-registration](https://developers.reddit.com/app-registration) before January 12, 2027. The page asks for "the account information associated with your API app" and a personal Reddit account, and says "You'll need a human Reddit account to register."

The older rule still applies until then. Reddit's [Responsible Builder Policy](https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy) (updated October 5, 2026) says "You must request access and get explicit approval before accessing any Reddit data through our API." The [Data API Wiki](https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki) adds: "Traffic not using OAuth or login credentials will be blocked." Tutorials that tell you to open reddit.com/prefs/apps, click "create app" and copy a key describe a process that no longer gives new users access.

## Three ways to search Reddit from an AI assistant

| | MCP server with your Reddit app | Search API in your own code | Hosted research tool |
|---|---|---|---|
| What you set up | A local MCP server in Claude Desktop, Claude Code or Cursor | A script that calls `oauth.reddit.com/search` | An MCP connection or API key for the tool |
| Reddit credentials | Client ID and secret of an app Reddit already approved | Same | None on your side |
| Rate limit | Reddit's 100 queries a minute per OAuth client ID, averaged over 10 minutes; some servers cap themselves lower | Same | The tool's own limits |
| Cost | Free for approved non-commercial use; commercial use needs Reddit's written approval and a contract | Same | The tool's pricing |
| What breaks it | No new credentials since October 31, 2026; unregistered apps lose access from January 12, 2027; public API access ends March 2027 | Same | Results are the tool's selection and summary, not full threads |
| Best for | Asking about threads in a chat, with you choosing the subreddit | Repeatable searches, pagination, saving results | People with no approved Reddit app |

A fourth option, the "no API key" MCP servers, read Reddit's logged-out `.json` pages, its RSS feeds or a third-party copy of Reddit. From the network we tested on, every logged-out `.json` request returned 403, and Reddit set November 13, 2026 as the end of RSS support. Treat keyless servers as unreliable, and read the section on Reddit's rules before you use a copy of Reddit's data.

## Reddit MCP servers compared

The open-source Reddit MCP servers with the most GitHub stars, as of November 15, 2026:

| Repository | Stars | Latest release or commit | Reddit auth | Search tool | Notes |
|---|---|---|---|---|---|
| [karanb192/reddit-mcp-buddy](https://github.com/karanb192/reddit-mcp-buddy) | 897 | v1.3.0 on npm, November 11, 2026 | Required: approved client ID and secret; username and password or a refresh token optional | `search_reddit` | Also `browse_subreddit`, `get_post_details`, `user_analysis`, `find_subreddits`. Posting is off unless you turn it on. Caps itself at 60 requests a minute app-only, 100 with a user |
| [adhikasp/mcp-reddit](https://github.com/adhikasp/mcp-reddit) | 438 | Last commit May 11, 2025 | None in its config | None | Fetches hot threads and post content only |
| [jordanburke/reddit-mcp-server](https://github.com/jordanburke/reddit-mcp-server) | 331 | v2.0.2 on npm, November 14, 2026 | Optional client ID and secret; keyless mode without them | `search_reddit` | 17 read tools plus write tools. Keyless mode reads RSS (until November 13, 2026) and the Arctic Shift archive, which its README calls "a third-party copy of Reddit" whose scores and comment counts lag |
| [Arindam200/reddit-mcp](https://github.com/Arindam200/reddit-mcp) | 301 | Last commit December 21, 2025 | Client ID and secret (PRAW) | `search_posts` | README still points to reddit.com/prefs/apps for credentials |
| [Hawstein/mcp-server-reddit](https://github.com/Hawstein/mcp-server-reddit) | 185 | Last commit June 10, 2026 | None in its config | None | Front page, subreddit listings, post content and comments |
| [eliasbiondo/reddit-mcp-server](https://github.com/eliasbiondo/reddit-mcp-server) | 167 | v0.2.1 on PyPI, October 24, 2026 | Optional client ID and secret | `search`, `search_subreddit` | Its README warns Reddit blocks anonymous requests "from many networks" with "HTTP 403: You've been blocked by network security" |

The two most active projects, reddit-mcp-buddy and reddit-mcp-server, are both listed in the [official MCP registry](https://registry.modelcontextprotocol.io) under `io.github.karanb192/reddit-mcp-buddy` and `io.github.jordanburke/reddit-mcp-server`. The registry also lists many hosted Reddit servers run by companies; a hosted server reads Reddit on its operator's terms, so check those terms before you send it your queries.

reddit-mcp-buddy's README puts the current situation plainly: "You need Reddit API credentials that Reddit has already approved." The snippets below use it, because its tools are read-only unless you enable posting and it refuses to start the write tools over HTTP.

## Install a Reddit MCP server in Claude, Cursor and ChatGPT

Each snippet runs the server with `npx`, so install Node.js first. Replace the placeholder values with your approved app's client ID and secret.

### Claude Desktop

Open **Settings > Developer > Edit Config**, which opens `claude_desktop_config.json` (`~/Library/Application Support/Claude/` on macOS, `%APPDATA%\Claude\` on Windows), and add the server:

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}
```

Quit Claude Desktop completely and reopen it. To see the tools, click the "Add files, connectors, and more" button in the message box, then **Connectors > Manage connectors**. reddit-mcp-buddy also ships a one-click Claude Desktop extension, `reddit-mcp-buddy.mcpb`, on its releases page; you enter the same two values in its settings.

### Claude Code

`claude mcp add` takes Claude's own options, then `--`, then the command that starts the server:

```bash
claude mcp add --transport stdio reddit -s user \
  -e REDDIT_CLIENT_ID=YOUR_CLIENT_ID -e REDDIT_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -- npx -y reddit-mcp-buddy
```

`-s user` makes the server available in every project; leave it out to add it to the current project only.

### Cursor

Put the server in `~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` in one project. Cursor can read the secrets from your environment instead of the file:

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "${env:REDDIT_CLIENT_ID}",
        "REDDIT_CLIENT_SECRET": "${env:REDDIT_CLIENT_SECRET}"
      }
    }
  }
}
```

### ChatGPT

ChatGPT connects only to remote MCP servers, so a Reddit server running on your computer cannot be added directly. OpenAI's help page on [connecting custom MCP servers](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt) says full MCP is for Business and Enterprise/Edu workspaces, that "Pro users can connect custom MCP servers with read/fetch permissions", and that a server on a private network or developer machine needs OpenAI's Secure MCP Tunnel. You add one from **Plugins**, then the plus button, then **Add custom MCP server**.

reddit-mcp-buddy can run over HTTP (`npx -y reddit-mcp-buddy --http`), but its README warns that "HTTP mode has no authentication." Do not expose it to the internet with your Reddit credentials inside. For ChatGPT, a hosted research tool is the simpler route.

## Reddit search API endpoint and parameters

Reddit's search endpoint is `GET /search` for all of Reddit or `GET /r/{subreddit}/search` for one subreddit, called on `https://oauth.reddit.com` with a bearer token and the `read` scope. The parameters, from Reddit's [API documentation](https://www.reddit.com/dev/api/#GET_search):

| Parameter | Values | What it does |
|---|---|---|
| `q` | Up to 512 characters | The search query |
| `restrict_sr` | Boolean | Limit results to the subreddit in the path; set it whenever you search one subreddit |
| `sort` | `relevance`, `hot`, `top`, `new`, `comments` | Result order |
| `t` | `hour`, `day`, `week`, `month`, `year`, `all` | Time window |
| `limit` | Default 25, maximum 100 | Results per page |
| `after`, `before` | A fullname such as `t3_abc123` | Page forward or back from that item |
| `type` | Comma-separated `sr`, `link`, `user` | Search subreddits, posts or users |
| `count`, `show`, `sr_detail`, `include_facets`, `category` | See the docs | Rarely needed |

Search results are a Listing. Each page returns an `after` value, the fullname of the last item, which you pass back to get the next page; Reddit's docs say listings "do not use page numbers because their content changes so frequently." Search does not return comments: to read a thread, fetch its permalink with the same token.

Tokens come from `https://www.reddit.com/api/v1/access_token`. For read-only search, Reddit's [OAuth2 docs](https://github.com/reddit-archive/reddit/wiki/OAuth2) describe an app-only token: POST `grant_type=client_credentials`, with the client ID and secret as HTTP Basic auth. "All bearer tokens expire after 1 hour", and API requests "should be made to https://oauth.reddit.com, NOT www.reddit.com."

## Python example: search Reddit with requests

This script gets an app-only token, searches one subreddit, follows `after` for a second page, and waits when the rate-limit headers say the window is used up. It needs only `requests`.

```python
import os
import time

import requests

CLIENT_ID = os.environ["REDDIT_CLIENT_ID"]
CLIENT_SECRET = os.environ["REDDIT_CLIENT_SECRET"]
# Reddit's format: <platform>:<app ID>:<version> (by /u/<reddit username>)
USER_AGENT = os.environ.get(
    "REDDIT_USER_AGENT", "python:thread-finder:v0.1 (by /u/YOUR_REDDIT_USERNAME)"
)
TOKEN_URL = "https://www.reddit.com/api/v1/access_token"
API_BASE = "https://oauth.reddit.com"  # token requests go to www, API calls to oauth


def get_token():
    """App-only token (client_credentials grant). Tokens last one hour."""
    resp = requests.post(
        TOKEN_URL,
        auth=(CLIENT_ID, CLIENT_SECRET),
        data={"grant_type": "client_credentials"},
        headers={"User-Agent": USER_AGENT},
        timeout=30,
    )
    if resp.status_code == 401:
        raise RuntimeError("401 from access_token: wrong client ID or secret, or access revoked")
    resp.raise_for_status()
    return resp.json()["access_token"]


def search(query, subreddit=None, sort="relevance", t="all", limit=25, max_pages=2):
    """Yield posts matching query, across Reddit or inside one subreddit."""
    headers = {"Authorization": f"bearer {get_token()}", "User-Agent": USER_AGENT}
    path = f"/r/{subreddit}/search" if subreddit else "/search"
    params = {"q": query, "sort": sort, "t": t, "limit": limit, "type": "link"}
    if subreddit:
        params["restrict_sr"] = "true"
    for _ in range(max_pages):
        resp = requests.get(API_BASE + path, headers=headers, params=params, timeout=30)
        if resp.status_code == 429:
            time.sleep(float(resp.headers.get("X-Ratelimit-Reset", 60)))
            continue
        resp.raise_for_status()
        listing = resp.json()["data"]
        for child in listing["children"]:
            post = child["data"]
            yield {
                "title": post["title"],
                "subreddit": post["subreddit"],
                "score": post["score"],
                "num_comments": post["num_comments"],
                "created_utc": post["created_utc"],
                "url": "https://www.reddit.com" + post["permalink"],
            }
        if float(resp.headers.get("X-Ratelimit-Remaining", 1)) < 1:
            time.sleep(float(resp.headers.get("X-Ratelimit-Reset", 60)))
        if not listing.get("after"):
            break
        params["after"] = listing["after"]


if __name__ == "__main__":
    for post in search("standing desk", subreddit="BuyItForLife", sort="top", t="year"):
        print(post["score"], post["num_comments"], post["title"], post["url"])
```

Set `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` in your environment, and put your own Reddit username in the User-Agent. Reddit's Data API Wiki asks for that format and warns that "Many default User-Agents (like "Python/urllib" or "Java") are drastically limited." We ran the script with fake credentials on November 15, 2026 and got the 401 branch; the search path needs real approved credentials.

The same search in [PRAW](https://pypi.org/project/praw/) (version 8.0.3, August 2026), which handles the token and paging for you:

```python
import os

import praw

reddit = praw.Reddit(
    client_id=os.environ["REDDIT_CLIENT_ID"],
    client_secret=os.environ["REDDIT_CLIENT_SECRET"],
    user_agent="python:thread-finder:v0.1 (by /u/YOUR_REDDIT_USERNAME)",
)
results = reddit.subreddit("BuyItForLife").search(
    "standing desk", sort="top", time_filter="year", limit=50
)
for post in results:
    print(post.score, post.num_comments, post.title, "https://www.reddit.com" + post.permalink)
```

PRAW sets `restrict_sr` for you. Use `reddit.subreddit("all").search(...)` to search all of Reddit.

## The public .json endpoints in 2026

Adding `.json` to a Reddit URL used to return the page as JSON with no account. On November 15, 2026, from the network we tested on, it did not:

| Request (logged out) | Result |
|---|---|
| `www.reddit.com/search.json?q=...` with three different User-Agents | 403, HTML page "You've been blocked by network security" |
| `www.reddit.com/r/redditdev/search.json?q=api&restrict_sr=1` | 403, same page |
| `www.reddit.com/r/ClaudeAI/new.json` | 403, same page |
| `oauth.reddit.com/search?q=...` with no token | 403, same page |
| `old.reddit.com/search.json?q=...` | 302 redirect to the login page |
| `POST www.reddit.com/api/v1/access_token` with no or fake credentials | 401, `{"message": "Unauthorized", "error": 401}` |
| `www.reddit.com/r/redditdev/.rss` | 200, an Atom feed, two days after Reddit's November 13 end date |

Reddit says the block covers hosted networks in particular: "If you're accessing Reddit from an IP address in a hosted service provider's netblock, you will be required to have a valid OAuth token or be logged in." Results from a home connection can differ, but Reddit's wiki says traffic without OAuth or login credentials "will be blocked", so code built on logged-out `.json` requests should be expected to fail. Reddit's robots.txt disallows all crawling and points to its [Public Content Policy](https://support.reddithelp.com/hc/en-us/articles/26410290525844-Public-Content-Policy); the Data API Wiki notes that robots.txt "is for search engines, not Data API users."

## Errors and limits when an assistant searches Reddit

| Symptom | Cause | Fix |
|---|---|---|
| 403 with an HTML page "You've been blocked by network security" | A request with no OAuth token, often from a hosted network | Use an OAuth token on `oauth.reddit.com`; keyless servers fail the same way |
| `resp.json()` fails on a `.json` URL | The response was that 403 HTML page, not JSON | Same fix |
| 401 `{"message": "Unauthorized", "error": 401}` from `access_token` | Wrong or missing client ID and secret, or credentials sent in the POST body instead of Basic auth | Send them as HTTP Basic auth; check the app still has access |
| reddit.com/prefs/apps does not give you working credentials | New public API requests closed on October 31, 2026 | Use credentials you already hold, or a hosted research tool |
| MCP tools say credentials are needed | The server started without `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` | Add both to the server's `env` block and restart the client |
| `X-Ratelimit-Remaining` reaches 0, then requests fail | Over 100 queries a minute per client ID, averaged over 10 minutes | Wait `X-Ratelimit-Reset` seconds; cache results; lower page counts |
| Very slow or failing requests with a default User-Agent | Reddit limits default agents like "Python/urllib" | Use `platform:app-id:version (by /u/username)` |
| Search returns posts but no comments | Search returns Listings of posts | Fetch each post's permalink for its comments |
| Claude Code's web fetch says "Claude Code is unable to fetch from www.reddit.com" | The built-in fetch tool would not open reddit.com in our test | Use an MCP server with credentials, or a research tool |
| The server does not appear in Claude Desktop | Invalid JSON, or the app was not fully restarted | Fix the JSON, quit and reopen; read `mcp*.log` in `~/Library/Logs/Claude` or `%APPDATA%\Claude\logs` |
| Your app stops working in 2027 | Not registered by January 12, 2027, or public access ended in March 2027 | Register at developers.reddit.com/app-registration; plan for March 2027 |

## Reddit's rules on commercial use and AI training

Reddit's terms separate reading threads for yourself from building a product on them, and they treat model training as its own case. Quoted from Reddit's pages as of November 15, 2026:

- **Commercial use needs permission and a contract.** "You cannot use any Reddit developer tools and services for commercial purposes without first getting our permission." Reddit counts "any use of our services by a business or on behalf of a business or as part of a monetized product or service", and its examples include "Services, research, or data access for fees" and "Free product features available for upsell". Using Reddit data "to power, augment, or enhance your product or service for any commercial purposes" requires permission, "and we'll require a contract." ([Developer Platform & Accessing Reddit Data](https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data), updated May 28, 2026)
- **No model training without consent.** "You may not use content on Reddit as an input for any model training without explicit consent from Reddit. Commercial use of any model trained with Reddit data is prohibited without explicit approval." (same page) The [Developer Terms](https://redditinc.com/policies/developer-terms) (revised March 24, 2026) bar using Reddit data, "including by accessing our API or indexing, caching, or crawling", to "train large language, artificial intelligence, or other algorithmic models or related services without our permission."
- **What the API license covers.** The [Data API Terms](https://redditinc.com/policies/data-api-terms) (revised July 20, 2026) license you "to copy and display the User Content using the Data API solely as necessary to develop, deploy, distribute, and run your App to your App Users", and say no right is implied "to use User Content for other purposes, such as for training a machine learning or AI model, without the express permission of rightsholders." They also forbid deriving revenue from the APIs "unless there is express written approval from Reddit."
- **No ads next to Reddit content.** "You cannot display Reddit content and run advertisements within your app, website, or other services."
- **Research has one route.** "The only official and authorized avenue for performing research using Reddit data is through the Reddit For Researchers (RFR) program." The Responsible Builder Policy adds: "Any research that uses Reddit data collected outside of the RFR Program is in violation of this policy."
- **Deleted content must go.** "You must remove any user content in your possession that has been deleted from Reddit", and Reddit recommends "routinely deleting any stored user data and content within 48 hours." (Data API Wiki)
- **No sensitive inferences.** The Responsible Builder Policy forbids processing data "to derive or infer potentially sensitive characteristics about Reddit users (e.g., health, political affiliation, sexual orientation)."

These rules apply to the data, whichever route fetched it. A keyless MCP server or a third-party archive does not change what you may do with Reddit content.

## Finding Reddit threads without Reddit credentials

A hosted research tool runs the search on its side and returns thread links with a short account of what each says, so you need no Reddit app. Hyperresearch's [Answers](/answers) tool can return Reddit or forum threads for questions about experiences or opinions; each one is labeled "community discussion, not quote-checked", and its summary is a search model's summary of the thread, never the thread's own words.

Whatever tool you use, open the thread before you rely on it. A summary of a discussion is not a quote, and upvotes measure agreement, not accuracy. For giving an agent general web search, see [How to add web search to an AI agent](/guides/add-web-search-to-ai-agent); for checking what an assistant cites, see [How to verify citations in AI output](/guides/verify-citations-in-ai-output); for research runs inside Claude Code, see the [Claude Code research harness](/guides/claude-code-research-harness).

## Sources

- Reddit Changelog, October 8, 2026: https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026
- Reddit app registration: https://developers.reddit.com/app-registration
- Reddit Data API Wiki (updated May 11, 2026): https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki
- Responsible Builder Policy (updated October 5, 2026): https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy
- Developer Platform & Accessing Reddit Data (updated May 28, 2026): https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- Public Content Policy (updated October 6, 2026): https://support.reddithelp.com/hc/en-us/articles/26410290525844-Public-Content-Policy
- Data API Terms (revised July 20, 2026): https://redditinc.com/policies/data-api-terms
- Developer Terms (revised March 24, 2026): https://redditinc.com/policies/developer-terms
- Reddit API documentation, search: https://www.reddit.com/dev/api/#GET_search
- Reddit OAuth2 documentation: https://github.com/reddit-archive/reddit/wiki/OAuth2
- Official MCP registry: https://registry.modelcontextprotocol.io
- Connect to local MCP servers (Claude Desktop): https://modelcontextprotocol.io/docs/develop/connect-local-servers
- Claude Code MCP documentation: https://code.claude.com/docs/en/mcp
- Cursor MCP documentation: https://cursor.com/docs/context/mcp
- Connecting custom MCP servers in ChatGPT: https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt
- PRAW on PyPI: https://pypi.org/project/praw/
