Connect Discourse to Your AI Agent

Search existing discussions before responding in the relevant topic.

7 tools API key

Try a Discourse Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Discourse

Collect Relevant Community Answers

Find matching topics and summarize the returned discussion.

/oo Discourse: Search our Discourse forum for [question or keywords]. Read the relevant topic IDs from the results, summarize the returned answers, and include topic links.

Post a Supplied Reply

Publish the message to the intended topic.

/oo Discourse: Read Discourse topic [numeric topic ID], then post this reply to it: [reply text]. Report the created post ID.

Start Working with Discourse

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Discourse

Connect an API key, forum URL, and API username.
Connect Discourse →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

The API user needs access to the categories and posting actions you select.
A topic read returns the posts included in the response, which may not cover a long topic’s entire history.

Discourse Tools

This connection reads Discourse topics and categories, searches forum content, and creates topics or replies under the connected API user.

Forum Reading and Search

Read visible topics and categories and search discussion content.

Topics and Replies

Create a topic with its first post or reply to an existing topic.

7 tools

List Latest Topics

List the latest topics visible to the authenticated Discourse API user.

discourse.list_latest_topics

List Categories

List Discourse categories visible to the authenticated API user.

discourse.list_categories

List Category Topics

List topics for one Discourse category.

discourse.list_category_topics

Get Topic

Read one Discourse topic and its returned posts.

discourse.get_topic

Search

Search Discourse content using the official search query syntax.

discourse.search

Create Topic

Create a new Discourse topic with a first post.

discourse.create_topic

Create Post

Create a reply post in an existing Discourse topic.

discourse.create_post

Frequently Asked Questions

Whose name appears on a new post?

Posts use the configured API username and the permissions associated with the API key.

Can I include formatting in a topic or reply?

Yes. The post body accepts raw Markdown. A new topic also needs a title.

Can I search within a particular category?

Use Discourse search syntax in the query, or list topics using the category slug and numeric ID.