Skip to main content
Glama
Reddit MCP Server

Reddit MCP Server

by Jing-yilin

Reddit MCP Server

MCP server for Reddit API - Access Reddit data through a unified API interface with TOON format for 90%+ token savings.

Features

  • Fetch hot/new/top posts from any subreddit

  • Get detailed post content including comment trees

  • Search Reddit posts by query

  • Get user profile information and activity

  • Get subreddit information

  • Returns data in TOON format for token efficiency

  • Proxy support for enterprise environments

Related MCP server: Reddit Buddy MCP

Installation

npm install @yilin-jing/reddit-mcp

Or run directly:

npx @yilin-jing/reddit-mcp

Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "@yilin-jing/reddit-mcp"],
      "env": {}
    }
  }
}

Environment Variables (Optional)

  • PROXY_URL - HTTP/HTTPS proxy URL

  • HTTP_PROXY - Alternative proxy setting

  • HTTPS_PROXY - Alternative proxy setting

Available Tools

Tool

Description

get_subreddit_hot

Get hot posts from a subreddit

get_subreddit_new

Get new posts from a subreddit

get_subreddit_top

Get top posts from a subreddit (with time filter)

get_post_content

Get post details with comments tree

search_posts

Search Reddit posts by query

get_user_info

Get Reddit user profile information

get_user_posts

Get posts submitted by a user

get_user_comments

Get comments made by a user

get_subreddit_info

Get subreddit information

Usage Examples

Get Hot Posts from a Subreddit

Tool: get_subreddit_hot
Args: { "subreddit": "programming", "limit": 10 }

Get Top Posts of the Week

Tool: get_subreddit_top
Args: { "subreddit": "askreddit", "time": "week", "limit": 20 }

Get Post Content with Comments

Tool: get_post_content
Args: { "post_id": "abc123", "comment_limit": 30, "comment_depth": 5 }

Search Posts

Tool: search_posts
Args: { "query": "typescript tutorial", "subreddit": "programming", "sort": "top", "time": "month" }

Get User Information

Tool: get_user_info
Args: { "username": "spez" }

Output Format

All responses are returned in TOON format for maximum token efficiency. Example cleaned post data:

id:"abc123"
title:"Example Post Title"
subreddit:"programming"
author:"username"
score:1234
upvoteRatio:0.95
comments:56
created:"2024-01-15T10:30:00.000Z"
url:"https://example.com"
permalink:"https://reddit.com/r/programming/comments/abc123/example_post/"

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Run tests
npm test

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Reddit's API for retrieving posts, comments, user information, and search functionality. Supports multiple authentication methods and comprehensive Reddit data operations including subreddit browsing, post retrieval, and user profile access.
      9
      1,654 npm
      1
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to browse Reddit, search posts, analyze user activity, and fetch comments without requiring API keys. Features smart caching, clean data responses, and optional authentication for higher rate limits.
      6
      6,037 npm
      895
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Reddit through the Reddit API, allowing users to search posts, retrieve saved content, fetch comments, reply to comments, and access detailed post information with comment trees.
      4
      -
    • A
      license
      A
      quality
      B
      maintenance
      Provides AI assistants with access to Reddit data for searching, browsing subreddits, and retrieving post details or user activity without requiring API keys. It enables tools to fetch content, nested comment trees, and public user feeds directly through the Model Context Protocol.
      6
      220 PyPI
      167
      MIT

    Appeared in Searches