Reddit MCP server for your agent

To give Claude, Cursor, ChatGPT or another MCP client Reddit data, add Apify's hosted MCP server with the Actors ticked below as tools (6 by default); the URL is in every config. Sign in with your Apify account or pass an API token; each call runs the Actor and returns Reddit records to the agent.

One click, signs in with Apify on first use:

Add to Cursor Add to VS Code

Any other client, one command (writes the config for 25+ agents, including Windsurf, Zed, Cline and Goose):

npx add-mcp "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter" --name apify-reddit

Server mode on Reddit Multi-Mode Scraper for Posts, Comments & Profiles also answers single HTTP requests.

Catalogue Actors: 9
In this bundle: 6
Official API: Limited
Data checked: 2026-11-12

Config for your client

Claude Code configterminal or .mcp.json

claude mcp add --transport http apify-reddit "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter"

Run the command in your project folder. Add --scope user to make it available in every project.
Start Claude Code, type /mcp, pick the server and sign in to Apify in the browser window.
No browser sign-in? Add --header "Authorization: Bearer YOUR_APIFY_TOKEN" to the command instead.

Sign-in: OAuth sign-in on first use, or a token header.

Claude Desktop configclaude_desktop_config.json

{
  "mcpServers": {
    "apify-reddit": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--tools",
        "fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

Easiest: open Customize, then Connectors, choose Add custom connector, paste the server URL (the ChatGPT tab shows it on its own) and sign in to Apify.
Local alternative (needs Node.js): merge this into claude_desktop_config.json (Settings, Developer, Edit config) and replace YOUR_APIFY_TOKEN.
Restart Claude Desktop and enable the server from the tools menu in a chat.

Sign-in: Connector with OAuth, or a token in the local config.

Cursor config~/.cursor/mcp.json

{
  "mcpServers": {
    "apify-reddit": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter",
      "headers": {
        "Authorization": "Bearer ${env:APIFY_TOKEN}"
      }
    }
  }
}

Save as ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one project. Merge with servers you already have.
Set APIFY_TOKEN in the environment Cursor starts from, or replace ${env:APIFY_TOKEN} with your token.
Open Cursor Settings, then MCP, and check that the server lists its tools.

Sign-in: Token read from the APIFY_TOKEN environment variable.

VS Code config.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apify-token",
      "description": "Apify API token",
      "password": true
    }
  ],
  "servers": {
    "apify-reddit": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter",
      "headers": {
        "Authorization": "Bearer ${input:apify-token}"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace.
Start the server from the file or the MCP servers view. VS Code asks for the token once and stores it securely.
Use the tools from Copilot Chat in agent mode.

Sign-in: Token prompted once and stored by VS Code.

ChatGPT configPlugins > Add custom MCP server

https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter

In ChatGPT on the web, open Plugins, select + and choose Add custom MCP server.
Name it, paste the URL under Connection as the Server URL and choose OAuth for authentication.
Accept the risk warning (I understand and want to continue), select Create as a plugin, then install the plugin from your plugins, sign in to Apify and use it in a new chat.

Sign-in: OAuth sign-in with your Apify account.

Codex CLI config~/.codex/config.toml

[mcp_servers.apify-reddit]
url = "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter"
bearer_token_env_var = "APIFY_TOKEN"

Add the block to ~/.codex/config.toml, or .codex/config.toml in a project.
Export APIFY_TOKEN in the shell that starts Codex. Or skip the token line and run codex mcp login to sign in.
Start codex and type /mcp to check that the tools are listed.

Sign-in: Token read from the APIFY_TOKEN environment variable.

Gemini CLI configterminal (writes ~/.gemini/settings.json)

gemini mcp add -t http -s user -H "Authorization: Bearer $APIFY_TOKEN" apify-reddit "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter"

Export APIFY_TOKEN first: the shell expands it and Gemini CLI saves the header, token included, in plain text in ~/.gemini/settings.json (keep that file private). In PowerShell write $env:APIFY_TOKEN instead of $APIFY_TOKEN. Drop -s user to save it in the project's .gemini/settings.json.
Start gemini and type /mcp to check that the server is connected and lists its tools.
Saved by hand, a remote server uses the httpUrl key for streamable HTTP (url means the older SSE transport).

Sign-in: Token header saved by gemini mcp add.

n8n AI Agent configMCP Client Tool node

https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/reddit-keyword-search-with-advanced-filters,vexaloom-labs/reddit-subreddit-post-and-comment-harvester,vexaloom-labs/reddit-comment-thread-scraper-with-score,nimbryxo-studio/reddit-multi-mode-scraper-for-posts-comments,dataspryva/reddit-user-profile-and-post-history-crawler-pro,dataspryva/reddit-subreddit-profile-rules-and-post-filter

Add an AI Agent node, then attach an MCP Client Tool node to its tool input.
Paste the URL as the endpoint and choose HTTP Streamable as the transport.
Choose Bearer auth and create a credential that holds your Apify token.

Sign-in: Bearer auth credential.

Validated, not executed: 7 of 7 checks pass

Uses Apify's hosted MCP endpoint over HTTPS
The tools parameter lists exactly the chosen Actors as owner/name
JSON configs parse and use the client's top-level key and the same URL
Codex TOML has a [mcp_servers.<name>] table with url and bearer_token_env_var
CLI commands quote the same URL and use the streamable HTTP transport
One-click install links decode back to the same URL and carry no token
Only placeholders, no real token

Official API or an Actor?

Reddit has an official API with limited access

Reddit is moving public data access to its Developer Platform. RSS support ends November 13, 2026; new public API access requests stopped October 31, 2026; access for unregistered apps starts closing January 12, 2027; remaining public API access ends in March 2027.

Commercial use requires a data agreement. Pricing is not published as a public rate card.

Registration and migration are required for apps; no replacement is offered for RSS outside communities you moderate.

Reddit Data API documentation

Public community data only; respect privacy and Reddit's terms; not legal advice.

Which Actor for which job

Reddit Subreddit Profile, Rules & Post Filter Scraper fits community research covering rules, wiki content, activity and filtered discussions; its output includes dataType and weekly_active_users.
Reddit Comment Thread Scraper with Score & Keyword Filters fits nested reply analysis with author and parent context; its output includes body and depth.
Reddit Keyword Search with Advanced Filters fits finding posts and optional matching comments by topic, with subreddit and engagement filters; its output includes keyword and upvote_ratio.
Reddit Multi-Mode Scraper for Posts, Comments & Profiles fits collecting posts, comments, profiles and community records together; its output includes recordType and source.
Reddit Multi-Mode Scraper with Advanced Pro Filters fits collecting mixed Reddit record types alongside a run summary; its output includes recordType and content.
Reddit Post Comment Thread & Filter Extractor fits extracting comments with parent-post metadata after applying thread filters; its output includes text and is_op.
Reddit Subreddit Post & Comment Harvester fits collecting subreddit posts with media context and optional nested comments; its output includes post_type and num_comments. Add this Actor to the MCP tool list before using it.
Reddit Subreddit Post Filter & Moderation Scraper fits collecting posts that pass filters and explaining blocked, private or empty subreddit results; its output includes recordType and score. Add this Actor to the MCP tool list before using it.

Where it stops

Token-based configurations require your own Apify API token, which authorizes Apify access rather than Reddit account access through OAuth. Recipe for Agents has not authenticated with Apify or Reddit for you. A configured connection does not guarantee that a subreddit or thread will be retrievable.

Every Reddit Actor in the catalogue

Actor	Returns	Fields	Store price	Last update
Reddit Subreddit Profile, Rules & Post Filter Scraper	Community profiles (with rules, wiki and weekly activity), filtered posts and capped comment trees from Reddit's public pages. Records are… Fields include subreddit_prefixed, title, post_title.	10	$0.99 per 1,000 results	2026-11-05
Reddit Comment Thread Scraper with Score & Keyword Filters	Reddit comment threads, nested replies included, with author, score, depth, tree path, edited/deleted flags, and parent relationships… Fields include post_title, author, body.	8	$0.99 per 1,000 results	2026-10-23
Reddit Keyword Search with Advanced Filters	Reddit posts and optional keyword-matched comments with score, subreddit, author, timestamps, source provenance, and data freshness, after… Fields include title, author, subreddit_prefixed.	13	$0.99 per 1,000 results	2026-11-09
Reddit Multi-Mode Scraper for Posts, Comments & Profiles	Reddit posts, comments, profiles and community records with engagement metrics, derived activity and per-record source provenance. Fields include subreddit_prefixed, title, author.	9	$0.99 per 1,000 results	2026-10-22
Reddit Multi-Mode Scraper with Advanced Pro Filters	One dataset row per Reddit post, comment, user profile or community, plus one run summary row. Fields include subreddit_prefixed, title, author.	9	$0.99 per 1,000 results	2026-11-06
Reddit Post Comment Thread & Filter Extractor	Dataset of Reddit comment records (author, body, score, depth, parent/thread links, awards, timestamps) plus one parent-post metadata… Fields include author, text, score.	7	$0.99 per 1,000 results	2026-11-08
Reddit Subreddit Post & Comment Harvester	Reddit subreddit posts with score, flair, selftext, images, galleries, video, polls and crosspost context, plus optional nested comment… Fields include subreddit_prefixed, title, author.	10	$0.99 per 1,000 results	2026-10-25
Reddit Subreddit Post Filter & Moderation Scraper	One record per post that passes your filters. Error and status records explain blocked, private, empty or no-match subreddits. Optional… Fields include subreddit_prefixed, title, author.	14	$0.99 per 1,000 results	2026-11-05
Reddit User Profile & Post History Crawler Pro	Reddit user records with split karma, account age, badges, bio/avatar and filtered posts or comments (media, awards, upvote ratio… Fields include username, post_karma, comment_karma.	11	$0.99 per 1,000 results	2026-11-11

Call these Actors from code: the Reddit data API page

Store links: reddit-subreddit-profile-rules-and-post-filter, reddit-comment-thread-scraper-with-score, reddit-keyword-search-with-advanced-filters, reddit-multi-mode-scraper-for-posts-comments, reddit-multi-mode-scraper-with-advanced-pro, reddit-post-comment-thread-and-filter-extractor, reddit-subreddit-post-and-comment-harvester, reddit-subreddit-post-filter-and-moderation, reddit-user-profile-and-post-history-crawler-pro

Reddit recipes for n8n

Reddit mentions to Slack
Monitor public Reddit posts for a keyword and send only the posts you have not seen before to a Slack channel.
RedditSlack
Reddit posts to Google Sheets
Collect public posts and comments from a subreddit into a Sheet for research, with duplicate protection and…
RedditGoogle Sheets
Reddit keyword monitor to Discord
Watch a public keyword across Reddit and drop new matches into a Discord channel through a webhook.
RedditDiscord
Reddit weekly digest to email
Build a weekly digest of public subreddit posts and email it to yourself or a team inbox.
RedditEmail

Troubleshooting

Why does the client say Unauthorized or invalid token?

Every Apify Actor tool needs a signed-in Apify account. Reconnect the server so the OAuth sign-in runs again, or switch to the token variant: an Authorization: Bearer header with an API token from Apify Console, Settings, API and integrations. For a local server the token must be in the server's own env block, not only in your shell.

Source: Apify MCP server README

Why did my agent's tool list change after an update?

Without a tools parameter Apify's server loads its default tool set, which changes between releases. The URLs on this site pin the tools with ?tools=, so the agent always gets the same Actor tool plus fetch-actor-details. Apify's README gives the same advice for production.

Source: Apify MCP server README

What happens when the agent sends input the Actor rejects?

The server answers with the Actor's input schema, so the agent can fix the arguments and call again. The fetch-actor-details tool in every scoped URL lets it read that schema before the first call.

Source: Apify MCP server README

Claude Code shows Needs authentication. Why?

The server is added but not signed in. Type /mcp in an interactive session and authenticate, or run claude mcp login with the server name. Headless runs with claude -p cannot complete OAuth, so sign in once interactively or use the --header token variant.

Source: Claude Code MCP documentation

Claude Code warns that a tool result is too large. What can I change?

Claude Code warns above 10,000 tokens of tool output and caps it at 25,000 by default (MAX_MCP_OUTPUT_TOKENS raises it). Ask the agent for fewer results per call, for example a lower result limit for the Actor.

Source: Claude Code MCP documentation

Cursor does not show the server's tools. What should I check?

Open the Output panel and pick MCP Logs to see the connection error. A deeplink install that does nothing usually means an older Cursor build; update it or paste the JSON into mcp.json by hand.

Source: Cursor MCP documentation

Every fix in one place

Questions

How do I get Reddit data into Claude?

Add the Reddit MCP configuration to Claude Desktop or Claude Code and complete Apify authentication with your own credentials. Ask Claude to inspect the chosen Actor's published schema before collecting public community records, posts or comments.

Does connecting MCP sign me into Reddit?

The Apify API token authenticates requests to Apify and does not grant Reddit account access through OAuth. Recipe for Agents has not signed into Reddit or Apify on your behalf.

Can Claude analyze nested Reddit replies?

Reddit Comment Thread Scraper with Score & Keyword Filters returns nested replies with depth and parent relationships. Collection limits and filtering can leave parts of a discussion outside the result.

Why can't Claude see the subreddit harvester tool?

The Reddit MCP configurations omit Reddit Subreddit Post & Comment Harvester from their tool list. Add that Actor to the configuration before asking Claude to use it.

Sources

Apify MCP server documentation, checked 2026-11-10
Reddit Data API documentation, checked 2026-11-09
Reddit Data API pricing
reddit.com/r/modnews/comments/1wubgvt/continuing_our_infrastructure_updates_whats, checked 2026-11-09
support.reddithelp.com/hc/articles/54058188280852, checked 2026-11-09
Reddit terms

Reddit MCP server for your agent

Config for your client

Claude Code configterminal or .mcp.json

Claude Desktop configclaude_desktop_config.json

Cursor config~/.cursor/mcp.json

VS Code config.vscode/mcp.json

ChatGPT configPlugins > Add custom MCP server

Codex CLI config~/.codex/config.toml

Gemini CLI configterminal (writes ~/.gemini/settings.json)

n8n AI Agent configMCP Client Tool node

Official API or an Actor?

Reddit has an official API with limited access

Which Actor for which job

Where it stops

Every Reddit Actor in the catalogue

Reddit recipes for n8n

Reddit mentions to Slack

Reddit posts to Google Sheets

Reddit keyword monitor to Discord

Reddit weekly digest to email

Troubleshooting

Questions

Sources