Skip to main content
Glama
reddirect

reddirect

by jeebus87

reddirect

Reddit MCP Server - No API Keys Required

Browse, post, comment, vote, and queue actions with timed delays from any MCP client. No API keys. Just install and go.

Node.js MCP License: MIT


Why reddirect?

Every other Reddit MCP server requires you to register an app, get API keys, and configure OAuth. reddirect doesn't. It uses Reddit's public OAuth for reads and a one-time browser login for writes - zero setup friction.

Other Reddit MCPs

reddirect

API keys

Required

Not needed

App registration

Required

Not needed

OAuth setup

Required

Not needed

Password stored

In config file

Never stored

Install time

10+ minutes

30 seconds


Related MCP server: reddit-rss-mcp

Quick Start

1. Install

npm install -g reddirect

2. Add to your MCP client

Add to your MCP client configuration:

{
  "mcpServers": {
    "reddirect": {
      "command": "npx",
      "args": ["-y", "reddirect"]
    }
  }
}

3. Use it

Reads work immediately - browse subreddits, search posts, check profiles.

For writes, run the authorize tool once. A Chrome window opens, you log into Reddit, and it closes automatically. That's it.


Tools

Tool

Description

check_session

Check auth status - anonymous or logged in

authorize

One-time browser login for write access

Tool

Description

browse_subreddit

Browse posts with sort (hot / new / top / rising / controversial) and time filters

get_post

Fetch a post with flat, depth-annotated comment tree

search_reddit

Search globally or within a subreddit

get_subreddit_info

Get description, rules, subscriber count

get_flairs

Get available post flairs for a subreddit (IDs and text)

get_user_profile

Get karma breakdown and account age

Tool

Description

create_post

Create text or link posts with optional flair (supports flair ID and text)

crosspost

Share an existing post to a different subreddit (auto-fetches original title)

reply

Reply to a post or comment

edit_content

Edit your own posts or comments

delete_content

Delete your own posts or comments

Tool

Description

vote

Upvote, downvote, or remove vote

save_item

Save a post or comment

unsave_item

Remove from saved items

get_saved_items

List your saved items

Tool

Description

get_inbox

View messages, mentions, and replies

mark_inbox_read

Mark all unread as read

get_subscriptions

List subscribed subreddits

subscribe_subreddit

Subscribe to a subreddit

unsubscribe_subreddit

Unsubscribe from a subreddit

Tool

Description

queue_action

Enqueue any write operation with a randomized delay (default 2-3 min)

queue_status

Check progress of queued items - pending, processing, completed, or failed

queue_cancel

Cancel a specific queued item or clear the entire queue

Space out multiple write operations with natural, randomized timing. Enqueue posts, replies, votes, or any write action - they execute sequentially with configurable delays between each.


How It Works

┌─────────────────────────────────────────────┐
│              MCP Client                      │
│          (Any MCP Client)                    │
└──────────────────┬──────────────────────────┘
                   │ stdio
┌──────────────────▼──────────────────────────┐
│              reddirect                       │
│                                              │
│  Reads ──► Anonymous OAuth ──► reddit API    │
│  Writes ─► User token (JWT) ──► reddit API   │
└─────────────────────────────────────────────┘

Reads use Reddit's public installed_client OAuth grant - no credentials needed.

Writes use a token_v2 JWT extracted from a one-time Chrome login via the DevTools Protocol. No passwords are stored. The token lasts ~24 hours.


Requirements

  • Node.js 18+

  • Google Chrome - only needed once for the authorize step (not needed for reads)


Troubleshooting

Problem

Fix

Writes say "authentication required"

Run the authorize tool

Chrome window doesn't appear

Make sure Google Chrome is installed

"Server error" during login

Reddit rate limit - wait 10 minutes

Session expired

Run authorize again (~24hr sessions)

Want to reset session

Delete ~/.reddirect/session.json


License

MIT - License

Available Tools

20 tools
authorizeAuthorize Reddit AccountA

One-time authorization: opens Reddit in your browser to connect your account. You click 'Allow', and reddirect gets permanent access. No API keys or passwords stored. Only needs to be done once.

Inputs: no named parameters.

browse_subredditBrowse SubredditA

Browse posts from a subreddit with sort options (hot, new, top, rising, controversial). For top and controversial, you can specify a time range.

Inputs: subreddit (required), sort, time, limit.

check_sessionCheck Reddit SessionA

Check if connected to a Reddit account. Shows username if authorized, or anonymous if not. Run 'authorize' tool to connect your account for write operations.

Inputs: no named parameters.

create_postCreate Reddit PostA

Create a new text or link post in a subreddit. Returns the permalink of the created post.

Inputs: subreddit (required), title (required), type, body, +1 more.

delete_contentDelete Post or CommentA

Delete your own Reddit post or comment.

Inputs: url (required).

edit_contentEdit Post or CommentA

Edit your own Reddit post or comment. Provide the URL of the content to edit.

Inputs: url (required), new_body (required).

get_inboxGet InboxA

Get your Reddit inbox messages including unread, mentions, and comment replies.

Inputs: filter, limit.

get_postGet Reddit PostA

Fetch a Reddit post and its comments. Returns comments as a flat array with depth and parent_id fields.

Inputs: url (required), comment_limit.

get_saved_itemsGet Saved ItemsB

Get your saved Reddit posts and comments.

Inputs: limit.

get_subreddit_infoGet Subreddit InfoB

Get subreddit information including description, rules, subscriber count, and whether it is NSFW.

Inputs: subreddit (required).

get_subscriptionsGet SubscriptionsA

List your subscribed subreddits.

Inputs: no named parameters.

get_user_profileGet User ProfileA

Get a Reddit user's public profile including karma breakdown and account age.

Inputs: username (required).

mark_inbox_readMark Inbox ReadB

Mark all unread inbox messages as read.

Inputs: no named parameters.

replyReply to Post or CommentC

Reply to a Reddit post or comment. Provide a full URL.

Inputs: url (required), body (required).

save_itemSave Post or CommentB

Save a Reddit post or comment to your saved items list.

Inputs: url (required).

search_redditSearch RedditB

Search Reddit globally or within a specific subreddit. Returns matching posts.

Inputs: query (required), subreddit, sort, time, +1 more.

subscribe_subredditSubscribe to SubredditB

Subscribe to a subreddit.

Inputs: subreddit (required).

unsave_itemUnsave Post or CommentB

Remove a Reddit post or comment from your saved items list.

Inputs: url (required).

unsubscribe_subredditUnsubscribe from SubredditB

Unsubscribe from a subreddit.

Inputs: subreddit (required).

voteVote on Post or CommentB

Upvote, downvote, or remove your vote on a single Reddit post or comment. One vote per call.

Inputs: url (required), direction (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation5/5

    Each tool targets a distinct action or resource (e.g., authorize, browse, create, delete, vote, save). No two tools have overlapping purposes; even similar operations like subscribe/unsubscribe are clearly differentiated.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in lowercase snake_case (e.g., browse_subreddit, create_post, get_inbox). Even single-word names like 'authorize' and 'reply' fit the verb-first pattern.

    Tool Count5/5

    With 20 tools, the server covers a wide range of Reddit operations without being bloated. The count is appropriate for a full-featured Reddit client, balancing usability and coverage.

    Completeness4/5

    The server covers core CRUD operations, voting, saving, searching, and inbox management. Missing a tool to list the user's own posts or comments, but this is a minor gap given the overall breadth.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.
      8
      27 PyPI
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      A dependency-free MCP server that reads Reddit through its RSS feeds, enabling search, browsing subreddits, and reading post comments without any API keys or authentication.
      3
      157 npm
      18
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that enables authenticated Reddit account actions like posting, commenting, voting, and messaging via the Reddit API.
      12
      32 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.
      -