Summary
This server connects Claude to Reddit via Apify's cloud scraping actors, giving you two main tools: reddit_fast_search for general queries across posts, comments, and users, and reddit_lead_monitor for filtering high-intent mentions while cutting through noise. You'll need an Apify API token to run it, which makes sense since it's offloading the scraping work to their infrastructure rather than hitting Reddit directly. Reach for this when you want Claude to pull Reddit data without managing rate limits or parsing HTML yourself. Works with Claude Desktop, Cursor, Windsurf, and VS Code via stdio transport.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
10 tools
REDDIT_CREATE_REDDIT_POSTCreates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.6 params
Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair.
Parameters* required
urlstringThe URL for a 'link' post. Required if `kind` is 'link'.
kindstringThe type of the post. Use 'self' for a text-based post or 'link' for a post that links to an external URL.one of
link · selftextstringThe markdown-formatted text content for a 'self' post. Required if `kind` is 'self'.
titlestringThe title of the post. Must be 300 characters or less.
flair_idstringOptional ID of the flair to apply to the post. Use the 'REDDIT_GET_USER_FLAIR' action to find available flair IDs for the specified subreddit. Omit this field entirely if no flair is needed.
subredditstringThe name of the subreddit (without the 'r/' prefix) where the post will be submitted.
REDDIT_DELETE_REDDIT_COMMENTDeletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.1 params
Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user.
Parameters* required
idstringThe full 'thing ID' (fullname, e.g., 't1_c0s4w1c') of the comment to delete; typically starts with 't1_'.
REDDIT_DELETE_REDDIT_POSTPermanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.1 params
Permanently deletes a Reddit post by its ID, provided the authenticated user has deletion permissions for that post.
Parameters* required
idstringThe full name (fullname) of the Reddit post to be deleted. This ID must start with 't3_' followed by the post's unique base36 identifier.
REDDIT_EDIT_REDDIT_COMMENT_OR_POSTEdits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.2 params
Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles.
Parameters* required
textstringThe new raw markdown text for the body of the comment or self-post.
thing_idstringThe full name (fullname) of the comment or self-post to edit. This is a combination of a prefix (e.g., 't1_' for comment, 't3_' for post) and the item's ID.
REDDIT_GET_USER_FLAIRFetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.1 params
Fetches the list of available link flairs (i.e., post flairs, not user flairs) for a given subreddit.
Parameters* required
subredditstringName of the subreddit (e.g., 'pics', 'gaming') for which to retrieve available link flairs.
REDDIT_POST_REDDIT_COMMENTPosts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.2 params
Posts a comment on Reddit, replying to an existing and accessible submission (post) or another comment.
Parameters* required
textstringThe raw Markdown text of the comment to be submitted.
thing_idstringThe ID of the parent post (link) or comment, prefixed with 't3_' for a post (e.g., 't3_10omtdx') or 't1_' for a comment (e.g., 't1_h2g9w8l').
REDDIT_RETRIEVE_POST_COMMENTSRetrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.1 params
Retrieves all comments for a Reddit post given its article ID (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.
Parameters* required
articlestringBase-36 ID of the Reddit post (e.g., 'q5u7q5'), typically found in the post's URL and not including the 't3_' prefix.
REDDIT_RETRIEVE_REDDIT_POSTRetrieves the current hot posts from a specified, publicly accessible subreddit.2 params
Retrieves the current hot posts from a specified, publicly accessible subreddit.
Parameters* required
sizeintegerThe maximum number of posts to return. Default is 5. Set to 0 to retrieve all available posts (or the maximum allowed by the Reddit API for a single request, typically up to 100 for this type of listing).default: 5
subredditstringThe name of the subreddit from which to retrieve posts (e.g., 'popular', 'pics'). Do not include 'r/'.
REDDIT_RETRIEVE_SPECIFIC_COMMENTRetrieves detailed information for a specific Reddit comment or post using its fullname.1 params
Retrieves detailed information for a specific Reddit comment or post using its fullname.
Parameters* required
idstringFullname of the comment or post to retrieve (e.g., 't1_c123456', 't3_x56789').
REDDIT_SEARCH_ACROSS_SUBREDDITSSearches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.4 params
Searches Reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict_sr` is set to False.
Parameters* required
sortstringThe criterion for sorting search results. 'relevance' (default) sorts by relevance to the query. 'new' sorts by newest first. 'top' sorts by highest score (typically all-time). 'comments' sorts by the number of comments.one of
relevance · new · top · commentsdefault: relevancelimitintegerThe maximum number of search results to return. Default is 5. Maximum allowed value is 100.default: 5
restrict_srbooleanIf True (default), confines the search to posts and comments within subreddits. If False, the search scope is broader and may include matching subreddit names or other Reddit entities.default: true
search_querystringThe search query string used to find content across subreddits.
Reddit MCP Server 🤖
An MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to high-performance Apify cloud actors.
🌟 Key Features
reddit_fast_search: Quickly search for Reddit posts, comments, or users. Best for general information gathering.reddit_lead_monitor: Find high-intent leads or brand mentions while filtering out noise.
⚡️ Quick Install
Choose your platform to install Reddit MCP in seconds:
Claude Desktop (macOS/Windows)
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"reddit-mcp": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": {
"APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
Cursor & Windsurf
- Open Settings -> MCP Servers.
- Add a new server:
- Name:
Reddit MCP - Type:
stdio - Command:
npx -y @practicaltools/reddit-mcp-server - Env:
APIFY_API_TOKEN=YOUR_TOKEN
- Name:
Claude Code (CLI)
claude-code --mcp @practicaltools/reddit-mcp-server="npx -y @practicaltools/reddit-mcp-server" --env APIFY_API_TOKEN=YOUR_TOKEN
VS Code (Copilot Agent)
Add to .vscode/mcp.json:
{
"mcpServers": {
"reddit-mcp": {
"command": "npx",
"args": ["-y", "@practicaltools/reddit-mcp-server"],
"env": { "APIFY_API_TOKEN": "YOUR_TOKEN" }
}
}
}
🔑 Getting Your Apify API Token
To use this server, you need an Apify API token.
- Sign up/Log in: Apify Console.
- Settings: Click the Settings icon in the bottom-left sidebar.
- Integrations: Select the Integrations tab at the top.
- Copy Token: Copy the string at the top of the page.
🛠 Local Development
If you want to contribute or run from source:
# Install dependencies
npm install
# Build the project
npm run build
# Run locally
node dist/index.js
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
📄 License
MIT License - see LICENSE for details.
Built with ❤️ by Practical Tools
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
APIFY_API_TOKEN*secretYour Apify API Token
Registryactive
Package@practicaltools/reddit-mcp-server
TransportSTDIO
AuthRequired
UpdatedJan 12, 2026