Let your agent do it
Paste this into Claude Code or whatever agent you use. It stops and asks when it needs you.
Set up Meowlendar for me
Self-host Meowlendar on this machine from https://github.com/fidgetcoding/meowlendar. Follow DEPLOY.md in the repo if anything here is unclear. Work in this order and verify each step before moving on. Never print secrets, and never commit apps/web/.env.local or supabase/.env.
Names: the project used to be called Poolendar. @poolendar/* packages are correct. Do not rename them.
DO THESE YOURSELF
1. Check prerequisites: node -v (22 or newer), pnpm -v, supabase --version, docker info. If Docker is not running, start it (colima start, if colima is installed). If a tool is missing, tell me what to install and stop.
2. Clone the repo and run pnpm install.
3. Run pnpm setup:local.
Verify: it exits 0 and apps/web/.env.local exists. If Supabase reports a container as "unhealthy", run it once more.
4. Start pnpm dev in the background.
Verify: curl -s -o /dev/null -w "%{http_code}" http://localhost:3000/login prints 200.
5. Run pnpm --filter meowlendar-mcp build.
Verify: packages/mcp/dist/index.js exists.
STOP AND ASK ME
6. Tell me I can sign in with demo@meowlendar.com / meowlendar right away, then ask me to open http://localhost:3000, click Sign up, create my own account, go to Settings > API Keys, click Generate, and paste the pk_ key to you.
Verify: curl -s -H "Authorization: Bearer <key>" http://localhost:3000/api/calendars returns JSON containing "local_calendars".
THEN WIRE THE MCP
7. Run, using the absolute path to the clone:
claude mcp add meowlendar -s user --env MEOWLENDAR_API_KEY=<key> --env MEOWLENDAR_API_URL=http://localhost:3000 -- node <clone>/packages/mcp/dist/index.js
Verify: claude mcp list shows meowlendar as Connected. A new session may be needed before its tools appear. Then call create_task with a title, scheduled_start, and scheduled_end, and confirm list_events for that day returns it with kind "task".
ASK ME BEFORE GOOGLE
8. Ask if I want Google sign-in or Google Calendar. If not, stop here. Everything works on the local calendar. The Google sign-in button does not work until the provider is configured.
If yes, follow DEPLOY.md section 2 and walk me through the Google Cloud Console clicks one at a time. You cannot do them for me. Have me download the client JSON locally; read it without printing secrets, add the credentials as that section shows, and restart.
9. On first Google sign-in, follow the automatic calendar-consent flow and let me approve it. For additional accounts, ask me to use Settings > Calendars > Connect Google Account.
Verify: the MCP list_calendars tool shows the accounts.
Finish by telling me which steps passed, which were skipped, and what is still running.Step by step
Never used GitHub? Start here. Every step says what it does. You don't need a GitHub account.
- You'll type a few commands. On a Mac, open the Terminal app (Applications, then Utilities).
Install the tools
Node runs the app. pnpm installs its parts. Supabase is the database, and it runs on your machine inside Docker.
node -v && pnpm -v && supabase --version && docker info
Each command prints a version. Node should be 22 or newer.
Get the code
Downloads Meowlendar from GitHub into a folder called meowlendar, then installs what it needs.
git clone https://github.com/fidgetcoding/meowlendar && cd meowlendar && pnpm install
An "Ignored build scripts" warning is fine.
Start the database
Starts Supabase on your machine and writes your settings file.
pnpm setup:local
Every line starts with ok. The first run takes a few minutes.
Start the app
Runs Meowlendar on your own computer.
pnpm dev
Open http://localhost:3000. You should see the Meowlendar sign-in page.
Make your account
Sign in with the demo account, demo@meowlendar.com / meowlendar, to look around a sample week. Or click Sign up and use any email and password; no email gets sent.
demo@meowlendar.commeowlendarYou land on the week view.
Connect your agentOptional
In the app, go to Settings, then API Keys, and click Generate. Copy the key. It's shown once.
pnpm --filter meowlendar-mcp build claude mcp add meowlendar -s user \ --env MEOWLENDAR_API_KEY=pk_your_key \ --env MEOWLENDAR_API_URL=http://localhost:3000 \ -- node /absolute/path/to/meowlendar/packages/mcp/dist/index.js
claude mcp list says Connected. Ask for a task with a start and end time and watch it land.
Add GoogleOptional
Google sign in and two way sync use your own Google Cloud client. The clicks are in DEPLOY.md.
Settings, then Calendars, lists every calendar on the account.
Host itOptional
DEPLOY.md covers hosted Supabase and Vercel. I haven't run those yet, so read SECURITY.md first.
Words you'll see
- Terminal
- The app where you type commands.
- GitHub
- Where the code lives. You can download it without an account.
- Clone
- Download a copy of the code.
- localhost
- Your own computer, acting as the server.