edstem-cli

Give your AI agent access to Ed Discussion.

Catch up on the forum, search threads, read lessons, grab slides, and post when you ask. Use it as a CLI, a local MCP server, or a hosted remote MCP server.

🦄 Part of unicorn. Live tools answer what is there now; unicorn answers what changed.

📖 Read the docs

Set up

Ask your agent (Claude Code, Codex, or anything with a terminal):

Read https://unicorn.tuuhub.com/docs/edstem/agent-setup.md and set up edstem-cli for me.

Or by hand:

npm install -g edstem-cli
edstem auth login
edstem units

edstem auth login opens Ed's token page and works out your Ed region.

Use it from

Where	How
Claude, ChatGPT or any web AI	Add https://edstem.tuuhub.com/mcp as a custom connector (edstem.org accounts; US and EU deploy their own). Remote MCP
Claude Code, Codex, Cursor	Run edstem-mcp, or install the agent skill.
Your terminal and scripts	edstem prints tables in a terminal and JSON in a pipe. Scripting

Study Boooooooooost

Ask in plain language, or run the command yourself:

Ask your agent	Command
“What did I miss on the forum?”	edstem threads UNIT --unread
“Any unanswered questions this week?”	edstem threads UNIT --unanswered --since 7d
“Find threads about the deadline.”	edstem threads search UNIT deadline
“Read thread 42 for me.”	edstem threads read UNIT#42
“What lessons are left in week 2?”	edstem lessons UNIT --module "Week 2"
“Download this lesson's slides.”	edstem files get LESSON --dest ./slides
“Archive the whole forum.”	edstem threads export UNIT --dest ./archive

UNIT is the course ID or code as Ed shows it. Writes always show a plan and ask first.

Learn more

• Install and sign in
• Threads: filters, catch-up, actions
• Export a forum
• Lessons and slides
• Files
• Posting
• MCP server: hosted, local, or your own Worker
• Configuration
• Troubleshooting
• Command reference

Build from source

npm ci
npm run check
npm test
npm run build

🦄 Part of unicorn

Live tools answer what is there now; unicorn answers what changed.

Project	Layer	What it does
🦄 unicorn	Memory	Remembers your campus sources and tells your agent what changed. Remote MCP.
moodle-cli	Live	Moodle. CLI, local and remote MCP.
edstem-cli (you are here)	Live	Ed Discussion. CLI, local and remote MCP.
ontrack	Live	OnTrack and Doubtfire. CLI only.

📖 All docs · CLIs overview · Connect an MCP client

License

MIT. See THIRD_PARTY_NOTICES.md for migrated remote MCP attribution.