Skip to content
Paathshala
Getting started

Install & run

Let your AI install it, or run one command.

Easiest: ask your AI to install it

Paste one prompt into the AI tool you already use. It installs Paathshala, connects itself over MCP and opens the app. No terminal needed.

1

Copy this prompt

Please set up Paathshala for me. It is a free study app that runs on my computer (the npm package "paathshala"), and you will fill it with courses, lessons and quizzes over MCP.

1. Check that Node.js 20 or newer is installed (node -v). If it is missing or older, install it, or tell me exactly how.
2. Connect yourself to the Paathshala MCP server: command "npx", arguments ["-y", "-p", "paathshala", "paathshala-mcp"].
   - Claude Code: claude mcp add --scope user paathshala -- npx -y -p paathshala paathshala-mcp
   - Other tools: add it to your MCP settings or MCP config file.
3. Start the app in the background with: npx -y paathshala --open
   Then check that http://localhost:3000 opens.
4. If you need a restart to load the new MCP server, tell me. Once connected, call get_overview to confirm it works and suggest a first course for me.

If you cannot run commands on my computer, walk me through these steps one at a time instead.
2

Open your AI tool

Use one that can run commands on your computer, so it can do the setup for you:

Claude Desktop>_Claude CodeChatGPT · CodexCursorWindsurfVS Code · Copilot
3

Paste it and send

Approve the commands it asks to run. It checks Node.js, connects itself to Paathshala over MCP and starts the app at localhost:3000. If it asks you to restart it, do that, then say “build me my first course”.

Using ChatGPT or Claude in a web browser? Paste it anyway. Browser chats can’t install software on your computer, so the AI walks you through each step instead.

Or install it yourself

Requirements

Run with npx

npx paathshala

Then open http://localhost:3000. Useful options:

npx paathshala --port 4000      # choose a port
npx paathshala --db ./my.db     # choose the library file
npx paathshala --open           # open the browser for you

Install globally

npm install -g paathshala
paathshala

Then connect your AI tool.

Note
Your library is created automatically on first run at ~/.paathshala/paathshala.db. See Backup & data.
PreviousOverviewNext Connect your AI tool