simple-reddit-mcp

A read-only Reddit MCP server that needs no Reddit account, no API key, and no browser. It reads threads, comments and subreddits from the Arctic Shift archive over plain keyless HTTP.

One runtime dependency, zeromcp, keeps simple-reddit-mcp lightweight and quick to start.

Requirements

• Python 3.11 or newer
• uv (recommended) or pip

Run it

uvx simple-reddit-mcp

The server speaks MCP over stdio: JSON-RPC on stdout, logs on stderr.

Configure your MCP client

Claude:

claude mcp add reddit --scope user -- uvx simple-reddit-mcp

or

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["simple-reddit-mcp"]
    }
  }
}

Codex — in ~/.codex/config.toml:

[mcp_servers.reddit]
command = "uvx"
args = ["simple-reddit-mcp"]

Tools

Implemented:

Not currently implemented:

Caveats

• Read-only. Voting, commenting and posting require Reddit auth
• score and num_comments are placeholders for ~36h. Arctic Shift archives a post the moment it appears and backfills vote data later, so fresh posts report 1 and 0. Rendered output flags anything under 36h old.
• Free service = no uptime SLA.

Development

uv sync --group dev
uv run --group dev pytest

To publish a new release to PyPI, bump version and push to master:

uv version --bump patch   # bumps pyproject.toml and relocks
git commit -am "release $(uv version --short)"
git push

Attribution

MIT licensed.

• Built on zeromcp (MIT).
• Data comes from Arctic Shift, a free service; be considerate with it.