Properlinx

AI connector

Connect Claude, ChatGPT, Codex or another MCP app to your Properlinx workspace. Ask about jobs, buildings, people, tasks, quotes and certificates in plain language, and get answers from your own data.

What it is

Properlinx is maintenance software for property managers. The AI connector is a remote MCP server. It lets your AI app work with your Properlinx workspace as you.

• The AI sees only what you see in the Properlinx app, with your role and your permissions.
• It reads by default. It can only change things if your workspace turns on action tools.
• One connection is one person in one workspace.

Who can use it

• Owners and office staff of a Properlinx workspace. Contractors, landlords and tenants can’t connect.
• The connector is off by default. Properlinx switches it on per workspace. To get it, ask us at hello@properlinx.com.
• Once it is on, owners and office staff find this address and the steps in the app, under Settings › AI connector.
• You need your own Properlinx account in that workspace, and an account with the AI app you use.

Connect

Use the server address above. There is no API key: you sign in to Properlinx in your browser.

Claude (web, desktop and mobile)

1. Open Customize › Connectors, select Add, then Add custom connector.
2. Name it Properlinx and paste the address. Keep the authentication settings Claude detects.
3. Select Add, then Connect. Sign in to Properlinx and choose Allow.

On Team and Enterprise plans, an Owner adds the connector under Organization settings › Connectors. Each member then connects with their own Properlinx account. Add it on claude.ai or in Claude Desktop, and it also works in the Claude mobile apps.

Claude Code

claude mcp add --transport http properlinx https://mcp.properlinx.com/mcp

Then run /mcp in Claude Code, choose properlinx, and sign in in the browser.

Codex

codex mcp add properlinx --url https://mcp.properlinx.com/mcp
codex mcp login properlinx

ChatGPT

1. On ChatGPT on the web, open Plugins, select +, then Add custom MCP server. In a company workspace, an admin may have to allow it first.
2. Name it Properlinx, enter the address above as the server URL, and choose OAuth for authentication. Select Create as a plugin, then install it.
3. Sign in to Properlinx and choose Allow.

Other MCP apps

Any app that supports remote MCP servers with OAuth sign-in can use the same address. Properlinx supports OAuth 2.1 with PKCE, dynamic client registration and client ID metadata documents.

What happens at sign-in

1. Your AI app opens Properlinx in the browser.
2. You sign in with your normal Properlinx account. If you belong to more than one workspace, you pick the one to connect, and come straight back.
3. A consent page shows which app is asking, which workspace it will read, and as whom. If action tools are on, it says so and lists what the app can do.
4. You choose Allow or Don’t allow. Allow sends you back to the AI app.

Your Properlinx password never reaches the AI app. The app gets an access token that lasts 1 hour and a refresh token that lasts 90 days. It renews them without asking you. Each refresh token works once, and a reused one ends the connection. Properlinx stores tokens only as hashes.

Tools

Read tools (15)

All are marked read-only and change nothing.

• Who is connected whoamiYour name and role, the workspace, its time zone and today’s date there, and which tools this connection has.
• List buildings list_buildingsEvery building with its address, number of units, and how many jobs are open and late.
• Building details building_detailsOne building: its details, owner and manager, each unit with the tenant’s name, and open jobs.
• Find jobs find_jobsSearch maintenance jobs by state, building, unit, trade, person, time window, priority or words.
• Count jobs count_jobsCount jobs per building, trade, person or status, filtered by state, building, unit, trade, person, time window, priority or words.
• Job details job_detailsOne job in full, with its latest activity and the chat messages you can see.
• Find people find_peopleSearch contractors, staff, landlords and tenants. Phone and email for contractors only.
• List tasks list_tasksThe office’s to-dos, open or done, with due date, priority and who has them.
• Pending decisions pending_decisionsWhat waits for the office: quotes, new jobs, landlord approvals, blocked jobs, unanswered offers, invoices to approve.
• Workspace numbers numbersDashboard figures: open jobs, emergencies, missed deadlines, spend against budget, time to resolve.
• List invoices list_invoicesContractor invoices with amount, VAT, status and dates. Needs the billing permission.
• Planned maintenance planned_maintenanceRecurring and statutory maintenance coming up per building, and what is overdue.
• Documents and certificates documents_and_certificatesDocuments and certificates with type, issuer and expiry date. Never the files themselves.
• Search job chats search_chatsSearch messages in the job chats you can open. Not direct or group chats.
• Team hours team_hoursHours logged per person in a period, approved and waiting. Never wages.

Action tools (13)

Only where the workspace has turned them on (see below). All are marked as changing data, so Claude and ChatGPT ask you before each one unless you change that in the app. They do only what your role and permissions allow in the app. Left out on purpose: deleting anything, invoices and payments, team and settings, lock and access codes, rent, and sign-offs.

• Create job create_jobCreate a maintenance job at a building, optionally with a checklist of things to fix.
• Add internal note add_job_noteAdd an internal note to a job. Only the office sees it.
• Send job message send_job_messageSend a message in a job’s chat. Everyone on the job sees it and may be notified.
• Set job priority set_job_priorityChange a job’s priority, and optionally its trade. The deadline follows the new priority.
• Assign job assign_jobGive a job to an in-house builder or a contractor. Needs the dispatch permission.
• Schedule job schedule_jobBook or move the visit for an assigned job. The people on it may be notified.
• Request quotes request_quotesAsk one or more contractors for a quote on a job. They are notified.
• Accept quote accept_quoteAccept a contractor’s quote in Properlinx: gives them the work at the quoted amount and declines the other quotes. No money is paid or moved. Needs the approve-spend permission.
• Turn down quote reject_quoteTurn down a contractor’s quote, with an optional reason. Needs the approve-spend permission.
• Close job close_jobClose a job whose work is done. Refused while something still has to happen first.
• Create task create_taskCreate an office to-do, for one person or the shared office list.
• Complete task complete_taskTick off an open task.
• Reopen task reopen_taskReopen a task that was ticked off.

Action tools: switching them on, and who is responsible

Three things must all be true. Properlinx checks them on every call.

1. Properlinx offers action tools to your workspace. They are off by default. Ask us at hello@properlinx.com.
2. The workspace owner turns on Let connected AI apps act in Settings › AI connector and accepts the responsibility statement.
3. You connect, or connect again, after that. People who connected earlier only have read tools until they do.

The responsibility statement says, in short:

• AI makes mistakes. It can be misled by text it reads, such as a message from a tenant. Messages it sends and quotes it accepts can’t always be taken back. Some AI apps run tools without asking first.
• The owner accepts, on behalf of the workspace, that the workspace decides who may use this, checks what its AI apps do, and is responsible for the result.
• Actions count as done by the person who connected the app.
• The AI app is a separate service, under your own agreement with its provider. Properlinx doesn’t review these actions and, as far as the law allows, isn’t liable for them.

Every action an AI app tries, done or refused, is logged. Settings › AI connector lists the most recent: the owner sees everyone’s, office staff see their own. The owner can turn action tools off there at any time. That applies from the next call, for every connection.

Example prompts

“Which jobs are late at Parkstraat 12, and who is working on them?”

Uses Find jobs with state late and that building. You get each late job with its due date, status and the person or contractor assigned.

“What is waiting for me today?”

Uses Pending decisions and List tasks. You get quotes to answer, new jobs to triage, jobs waiting on a landlord, and your own tasks due today.

“Which certificates expire in the next 60 days?”

Uses Documents and certificates. You get each certificate with its building, issuer and expiry date, soonest first, including any that have already expired.

“Find a plumber we have worked with who is usually on time.”

Uses Find people for contractors with the plumbing trade. You get their company, phone, email, rating, jobs done and on-time rate.

“Create an urgent plumbing job for the leak in unit 2B at Parkstraat 12, and ask Van Dam Plumbing for a quote.”

Needs action tools. Claude asks before Create job and again before Request quotes. The contractor is notified, and both actions appear in the activity log.

Privacy and data

• The AI app receives only what its tool calls return, as the person who connected. Properlinx sends nothing to any AI service on its own. What your AI app receives is handled under your account and your agreement with that app’s provider.
• Contact fields are limited. Contractors come with full contact details. Tenants come with name, unit and building only. Landlords and staff come without phone or email.
• The tools never return the fields for bank account numbers (IBANs), wages, notes on contacts, or lock and access codes, and never files. Job descriptions, chat messages and task notes come back as people wrote them: whatever someone typed there reaches the AI app. The connector doesn’t filter free text.
• For the connector, Properlinx stores each connection (the person, the workspace, the app’s name, what it may do, when it was made, last used and ended), the registration of apps that register themselves (name, web address, return addresses), tokens as hashes only, and a log of each action and refusal with a short summary. To limit abuse it counts requests per network address for an hour, and stores the address nowhere else. It keeps no record of each read call, only when a connection was last used.
• Properlinx never sees your conversation with the AI. It only receives the tool calls the AI app makes.
• An hourly cleanup deletes expired sign-in requests, codes and tokens from an hour after they expire, ends connections nobody used for 90 days, and deletes ended connections and unused app registrations after 90 days.

Full details are in our privacy policy. The rules for using the connector are in our Terms of use.

Disconnect

• In Properlinx: Settings › AI connector, then Disconnect. You can disconnect your own connections. The owner can disconnect any connection in the workspace. Properlinx stops answering it at once.
• In your AI app: remove the connector (in Claude, Customize › Connectors; in Claude Code, claude mcp remove properlinx; in Codex, codex mcp logout properlinx). If the app then revokes its token with Properlinx, the connection ends here too. Not every app does, so to be sure, also disconnect it in Properlinx.
• A connection also ends when the person leaves the workspace or is no longer owner or office staff, asks to delete their account, when Properlinx switches the connector off for the workspace, or after 90 days without use. An ended connection stays ended: connect again to use it.

Troubleshooting

“Not switched on for [your workspace]”

The connector is off for your workspace. Ask us at hello@properlinx.com to switch it on.

“Only the office can connect an AI app”

Only owners and office staff can connect. Other roles can’t.

“Choose a workspace first”

You belong to several workspaces. Tap Choose a workspace, pick the one the AI app may read, and you come back to the consent page.

“This request expired” or “Already answered”

A sign-in request is valid for 10 minutes and works once. Start again from your AI app.

The action tools don’t show up

Check all three: Properlinx offers them to your workspace, the owner turned them on, and you connected again after that. When it worked, the consent page says “It can also act for you”.

The AI app asks you to sign in again

Access tokens last an hour and renew by themselves. A new sign-in means the connection ended: it was disconnected, not used for 90 days, your role changed, or the connector was switched off. Connect again.

A tool answers “refused”

Properlinx applied the same rule as in the app, such as a missing dispatch or approve-spend permission, or a job that isn’t ready to close. Nothing was changed, and the refusal is in the activity log.

“Matches several”

A building, unit or person name fits more than one. For buildings and people the answer lists each match with what tells them apart (an address; a company, role or trade) and a reference your AI app can use to pick the right one. Or be more specific. A job always goes by its number, such as #123: a number no job has is never read as another job.

Invoices say you need the billing permission

Invoices follow the same permission as in the app. Ask your workspace owner.

Support

Email hello@properlinx.com. Tell us which AI app you use, roughly when it happened, and the message you saw. Never send passwords or tokens.