OwnerRez + Claude (OwnerRez MCP Server)

This lets you talk to your OwnerRez account using Claude, in plain English. Once it's set up, you can ask things like:

• "Who's checking in this week?"

• "How much did I make this month?"

• "Show me the owner statement for Jane Smith."

• "Which properties had the most bookings in the last 30 days?"

You don't need to be technical. Just follow the steps below in order. It takes about 15 minutes.

Before you start, you need three things

1. An OwnerRez account (with admin access, so you can create a key).

2. Claude Desktop — the free app. Download it here: https://claude.ai/download

3. Node.js — a free tool that runs this program. Download the "LTS" version here: https://nodejs.org — click the big button, open the file, and click through the installer.

What's the "Terminal"? It's an app on your computer where you type commands. On a Mac, press Cmd + Space, type Terminal, and press Enter. On Windows, search for PowerShell. You'll paste a few commands into it below — just copy, paste, and press Enter.

Related MCP server: Hospitable MCP Server

Step 1 — Download this program

Paste this into your Terminal and press Enter:

git clone https://github.com/palarkin/OwnerRez-MCP.git
cd OwnerRez-MCP

This downloads the program into a folder and moves you into it.

Step 2 — Get your OwnerRez key

1. Log in to OwnerRez.

2. Go to Settings → Advanced Tools → Developer/API Settings.

3. Click Create Personal Access Token, give it any name (like "Claude"), and create it.

4. Copy the token — it starts with pt_. You only see it once, so copy it now.

Step 3 — Add your email and key

In your Terminal, paste this to create your settings file:

cp .env.example .env
open -e .env      # on Windows use:  notepad .env

A text editor will open. Fill in the two lines with your OwnerRez email and the pt_ key you just copied, so they look like this:

OWNERREZ_EMAIL=you@example.com
OWNERREZ_TOKEN=pt_your_key_here

Save the file and close it. (This file stays on your computer and is never shared.)

Step 4 — Set it up

Paste these two commands (one at a time) and press Enter after each:

npm install
npm run build

The first downloads what the program needs; the second gets it ready to run. Wait for each to finish.

Check it works: paste node probe.mjs and press Enter. You should see ✅ Auth OK with your account name. If you do, everything's connected correctly. 🎉

Step 5 — Connect it to Claude

Paste this exactly — it plugs the program into Claude:

claude mcp add ownerrez --scope user -- node "$(pwd)/dist/index.js"

Then fully quit Claude Desktop and reopen it (don't just close the window).

Prefer to use the Claude Desktop app's settings instead? You can add it there under Settings → Connectors/MCP, pointing to the file path that pwd shows you followed by /dist/index.js. The command above is the easy way if you have the Claude command installed.

Step 6 — Try it!

In Claude, type something like:

"Using OwnerRez, who is checking in this week?"

That's it — you're done.

Optional — turn on guest messaging (advanced)

Everything above works with your regular key. Guest messaging (reading and sending messages to guests) needs one extra thing: an OwnerRez "OAuth app." It's more involved — set aside about 15 extra minutes. If you don't need messaging, skip this section entirely.

A) Create the OAuth app in OwnerRez

1. In OwnerRez, go to Settings → Advanced Tools → Developer/API Settings and click Create App.

2. Fill it in like this. The web addresses can be exactly these — they just have to be real addresses, not "localhost":

   • Name: Claude

   • Homepage URL: https://example.com

   • OAuth Redirect URL: https://example.com/callback

   • OAuth API scope: Full read and write

   • Token expiration policy: None – tokens do not expire

   • Webhook URL: https://example.com/webhook (leave Webhook User/Password blank)

3. Save it, then copy the Client ID (starts with c_) and the Client Secret (starts with s_). The secret is shown only once — copy it now.

4. Open the Users tab and click Grant Access To Me.

B) Get your messaging token

1. Open this web address in your browser — replace YOUR_CLIENT_ID with your Client ID:

   https://app.ownerrez.com/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=https://example.com/callback&scope=full&state=x

2. Click to approve. Your browser jumps to a page like https://example.com/callback?code=tc_.... The page itself doesn't matter — look at the address bar and copy the part after code= (it starts with tc_).

3. Back in your Terminal (in the same folder), paste this — filling in your Client ID, Client Secret, and the tc_ code — then press Enter:

   node oauth-setup.mjs YOUR_CLIENT_ID YOUR_CLIENT_SECRET YOUR_CODE https://example.com/callback

   Do this within 10 minutes of step 1 (the code expires quickly). It saves the token into your .env file automatically.

C) Restart

Fully quit and reopen Claude. Guest messaging is now on. ✅

Tip: keep https://example.com/callback identical everywhere — in the app settings, in the web address in B1, and in the command in B3. They must match exactly.

If something goes wrong

• node or git "command not found" → Node.js (or Git) isn't installed. Install Node.js from https://nodejs.org and try again.

• probe.mjs shows a 401 error → your email or key is wrong. Re-check the two lines in your .env file (the key must start with pt_), or make a new key in OwnerRez.

• Claude doesn't see the tools → make sure you fully quit and reopened Claude, and that Step 4 finished without errors.

Good to know

• Your key and email live only in the .env file on your computer. They are never uploaded or shared.

• Anything that would change your data (like updating a rate) always asks you to confirm first — it won't change anything on its own.

• Guest messaging needs one extra setup step (an OwnerRez "OAuth app"). Everything else works with just the key above — see the optional messaging section above to turn it on.

For developers

See BLUEPRINT.md for the architecture, the full list of tools, remote/HTTP hosting, and how to run the tests (npm test).