# Discourse MCP (MCP server)

> Discourse MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Discourse MCP CLI server (stdio) exposing Discourse tools via MCP. It has 77 GitHub stars, is released under the MIT license and runs locally with npx -y @discourse/mcp.

A Model Context Protocol (MCP) stdio server that exposes Discourse forum capabilities as tools and resources for AI agents.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/discourse/discourse-mcp |
| GitHub stars | 77 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @discourse/mcp |
| Remote URL | none |
| Needs API key | no |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | none |
| Last commit | Aug 25, 2026 |
| MCP registry name | io.github.discourse/mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "discourse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@discourse/mcp"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio discourse-mcp -- npx -y @discourse/mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "discourse-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@discourse/mcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "discourse-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@discourse/mcp"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `discourse_search`
- `discourse_read_topic`
- `discourse_read_post`
- `discourse_get_user`
- `discourse_list_user_posts`
- `discourse_filter_topics`
- `discourse_get_review_queue_count`: {} → { count, unit: "pendingreviewablequeueitems", status: "pending", scope }, where count is the authoritative number…
- `discourse_list_reviewables`: stable review filters and offset pagination → normalized reviewables with named status plus numeric statusid, current…
- `discourse_list_reviewable_topics`: {} → a non-exhaustive aggregation of pending topics at or above Discourse's minimum review priority.
- `discourse_get_reviewable`: { reviewableid; includeexplanation? } → refreshed bounded context, side-loaded references, editable fields, score…
- `discourse_perform_reviewable_action`: (only when writes enabled): { reviewableid; actionid; expectedversion?; additionalfields?; confirm: true } →…
- `discourse_get_chat_messages`
- `discourse_get_draft`
- `discourse_save_draft`
- `discourse_delete_draft`
- `discourse_list_private_messages`
- `discourse_read_private_message`
- `allowed_users`: and allowedgroups are direct records, not an expanded ACL. Public topics are rejected.
- `discourse_create_private_message`
- `discourse_reply_private_message`
- `discourse_invite_to_private_message`
- `discourse_create_post`
- `discourse_create_topic`
- `discourse_update_topic`
- `discourse_list_users`
- `discourse_create_user`
- `discourse_update_user`
- `discourse_upload_file`
- `user_id`: is required for avatar/profilebackground/cardbackground uploads
- `discourse_create_category`
- `discourse_select_site`

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/discourse-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.