Install TeacherTasksAI with your AI assistant.

Use Codex, Cursor, or Windsurf if you want to paste a setup prompt. Use the Terminal command for Claude Desktop. If your AI app is not listed, start with one of the supported apps.

Recommended setup

Copy this prompt into Codex, Cursor, or Windsurf. Your AI app will open the official setup instructions, connect your TeacherTasksAI account, and check that everything worked.

Install prompt
Please set up TeacherTasksAI from https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/teacher.
  1. Open Codex, Cursor, or Windsurf.
  2. Paste the prompt above.
  3. If your AI app asks for permission to save setup files, approve it. Those files let TeacherTasksAI appear inside your AI app.
  4. When your browser opens, approve the connection using the email for your TeacherTasksAI account.
  5. Restart your AI assistant if prompted.
  6. Ask: Check my TeacherTasksAI credit balance.
  7. After a task run, your assistant can save the finished result as a local Word document or Markdown file under ~/Documents/TasksAI/TeacherTasksAI/.
TeacherTasksAI handles your account, credits, and task library. Your AI app does the writing and saves files on your computer. TeacherTasksAI does not need to receive your finished documents.
If your AI app says npm is unavailable, install Node.js first. Node.js is a standard helper app, and it includes npm automatically. Go to nodejs.org, download the recommended installer, run it, then paste the TeacherTasksAI setup prompt again.
If you use Claude Desktop, use the Terminal command below. Claude Desktop usually needs that one copy-and-paste command before TeacherTasksAI appears inside Claude.

If your assistant is blocked

If setup from a prompt does not work, or if you use Claude Desktop, run this command in Terminal:

Terminal install command
npm exec --package=@tasksai/install --call 'tasksai-install teacher --source https://github.com/TasksAI-Official/tasksai-mcp-wrappers/tree/main/verticals/teacher --client codex'

The command above is for Codex. Change codex to claude-desktop, cursor, or windsurf if that is the app you use.

After Terminal finishes

  1. Approve the browser connection when it opens.
  2. Restart your AI app.
  3. Ask your AI app: Check my TeacherTasksAI credit balance.
Health check command
npm exec --package=@tasksai/install --call 'tasksai-install teacher doctor --client codex'
If Terminal says npm: command not found, install Node.js from nodejs.org, reopen Terminal, and run the command again.

Supported AI apps

These are the apps we have tested for TeacherTasksAI setup today.

Codex

Use --client codex.

Best path: paste the setup prompt, then restart Codex.

Claude Desktop

Use --client claude-desktop.

Best path: run the Terminal command, then restart Claude Desktop.

Cursor

Use --client cursor.

Best path: paste the setup prompt, then restart Cursor.

Windsurf

Use --client windsurf.

Best path: paste the setup prompt, then restart Windsurf.

If your AI app is not listed, use one of the supported apps above for now. We can add more apps after we test that setup works reliably.
Advanced manual setup

Most users should not need this. Use it only if the setup prompt and Terminal command both fail.

Codex TOML example

[mcp_servers.teacher] command = "python3" args = ["~/Library/Application Support/TasksAI/teacher/runtime/server.py"] [mcp_servers.teacher.env] TASKSAI_PRODUCT_ID = "teacher" TASKSAI_CLIENT = "codex" PYTHONPATH = "~/Library/Application Support/TasksAI/teacher/python" DOTENV_PATH = "~/Library/Application Support/TasksAI/teacher/.env"

Claude Desktop, Cursor, or Windsurf JSON example

{ "mcpServers": { "teacher": { "command": "python3", "args": ["~/Library/Application Support/TasksAI/teacher/runtime/server.py"], "env": { "TASKSAI_PRODUCT_ID": "teacher", "TASKSAI_CLIENT": "claude-desktop", "PYTHONPATH": "~/Library/Application Support/TasksAI/teacher/python", "DOTENV_PATH": "~/Library/Application Support/TasksAI/teacher/.env" } } } }
Manual setup does not expose your proprietary prompts. Credentials stay in the local .env file created by the installer. If your AI app does not expand ~, replace it with your full home folder path.