@practicaltools/reddit-mcp-server

Reddit MCP Server

An MCP server that allows AI agents to search Reddit or find specific leads by delegating the scraping task to Apify cloud actors.

Features

• reddit_fast_search: Quickly search for Reddit posts, comments, or users.
• reddit_lead_monitor: Find high-intent leads or brand mentions while filtering out noise.

🚀 Quick Links

Claude Desktop | Cursor IDE | Windsurf | VS Code | Claude Code

⚡️ Frictionless Installation (Recommended)

Choose your platform to install Reddit MCP in seconds:

1. Claude Desktop, Cursor, or Windsurf

Uses Smithery to automatically configure your apps:

• Claude Desktop: npx @smithery/cli install @practicaltools/reddit-mcp-server --config "{ \"APIFY_API_TOKEN\": \"YOUR_TOKEN\" }"
• Cursor IDE: npx @smithery/cli install @practicaltools/reddit-mcp-server --client cursor --config "{ \"APIFY_API_TOKEN\": \"YOUR_TOKEN\" }"
• Windsurf: npx @smithery/cli install @practicaltools/reddit-mcp-server --client windsurf --config "{ \"APIFY_API_TOKEN\": \"YOUR_TOKEN\" }"

2. Claude Code (CLI)

Just run this one-liner in your terminal:

claude-code --mcp @practicaltools/reddit-mcp-server="node /ABSOLUTE/PATH/TO/PROJECT/dist/index.js" --env APIFY_API_TOKEN=YOUR_TOKEN

3. VS Code (Copilot Agent)

Copy this to your .vscode/mcp.json:

{
  "mcpServers": {
    "@practicaltools/reddit-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PROJECT/dist/index.js"],
      "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: Go to Apify Console.
• Navigate to Settings: Click the Settings icon in the bottom-left sidebar.
• Integrations Tab: Select the Integrations tab at the top.
• Copy Token: You will see your API Token at the top of the page. Copy this string.

🚀 Multi-Platform Setup

1. Claude Desktop (macOS/Windows)

Add the following to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "@practicaltools/reddit-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PROJECT/dist/index.js"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

2. Cursor IDE

• Open Settings -> Cursor Settings.
• Go to Features -> MCP Servers.
• Click + Add New MCP Server.
• Set:
  • Name: Reddit Apify
  • Type: stdio
  • Command: node /ABSOLUTE/PATH/TO/PROJECT/dist/index.js
  • Env: Key=APIFY_API_TOKEN, Value=YOUR_TOKEN

3. Windsurf

• Open Settings -> MCP.
• Click Add Server.
• Enter the configuration similar to Cursor (Stdio mode).

4. VS Code (GitHub Copilot Agent Mode)

• Ensure you have the GitHub Copilot Chat extension installed.
• Create a file named .vscode/mcp.json in your project root:

{
  "mcpServers": {
    "@practicaltools/reddit-mcp-server": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PROJECT/dist/index.js"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

• Enable "MCP Support" in VS Code settings.

5. Claude Code (CLI)

When running claude-code, you can specify the MCP server:

claude-code --mcp @practicaltools/reddit-mcp-server="node /ABSOLUTE/PATH/TO/PROJECT/dist/index.js" --env APIFY_API_TOKEN=YOUR_TOKEN

6. ChatGPT & Lovable (via Bridge)

ChatGPT and Lovable do not natively support external MCP servers yet. To use them, you can use a bridging tool like mcp-bridge which exposes the tools as GPT Actions or a local API that Lovable can interact with.

7. Antigravity & Agentic Frameworks

To use this server with agentic coding assistants like Antigravity:

• Ensure the server is built (npm run build).
• Add the server information to your agent's configuration (usually a .json file or via a command).
• The agent will then be able to call reddit_fast_search and reddit_lead_monitor directly.

🛠 Development

# 1. Install dependencies
npm install

# 2. Build for production (Generates dist/index.js)
npm run build

# 3. Running in dev mode
npm run dev

Usage Tips

• Search Reddit: "Search Reddit for 'Best budget keyboards' in r/MechanicalKeyboards"
• Find Leads: "Monitor Reddit for people looking for 'Logo Design' in the last 24 hours."