Set it up

Two ways in. Pick the one that fits.

You need
Node 22 or newerpnpmSupabase CLIDocker Desktop or colima
Path one

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.
Path two

Step by step

Never used GitHub? Start here. Every step says what it does. You don't need a GitHub account.

  1. You'll type a few commands. On a Mac, open the Terminal app (Applications, then Utilities).
  2. 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.

  3. 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.

  4. 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.

  5. Start the app

    Runs Meowlendar on your own computer.

    pnpm dev

    Open http://localhost:3000. You should see the Meowlendar sign-in page.

  6. 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.

    You land on the week view.

  7. 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.

  8. 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.

  9. 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.

Read more