# Buildium MCP MCP

> Buildium MCP connects your AI agent directly to your entire property management system. You can manage everything—from checking unit availability and tracking tenant balances to listing all vendors and monitoring work orders—all through natural conversation. It puts your full Buildium data into any compatible client, letting you handle the whole portfolio from one place.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** rental-units, tenant-profiles, maintenance-tracking, portfolio-management, real-estate, property-oversight

## Description

Running a rental portfolio means juggling dozens of tasks: checking if Unit 4A is available, figuring out John Doe's outstanding balance, and seeing which maintenance tasks are overdue. This MCP lets your AI agent do that without you opening the Buildium dashboard. You talk to your agent like you’re talking to an employee, asking it to list all properties or pulling up a specific tenant profile. It pulls in everything you need—from company settings to vendor directories—and presents it instantly. If you're already using Vinkius for other services, adding this MCP gives your AI client access to core property data, making your whole workflow feel connected and simple.

## Tools

### get_company_info
Retrieves core information and settings about your Buildium account.

### get_property
Gets specific details for one individual property unit in the portfolio.

### get_tenant
Retrieves all detailed records and profile information for a single tenant.

### get_unit
Gets specific details about one rental unit, including its status and metadata.

### list_properties
Pulls a list of all properties that are part of your management portfolio.

### list_tasks
Lists every outstanding maintenance task recorded in the system.

### list_tenants
Retrieves a list containing all current and past tenants associated with your properties.

### list_units
Generates a comprehensive list of every unit managed within the portfolio.

### list_vendors
Provides an accessible list of all external contractors and vendors you use.

### list_work_orders
Shows a log of all maintenance work orders, including their status and assigned personnel.

## Prompt Examples

**Prompt:** 
```
List all my rental properties in Buildium.
```

**Response:** 
```
I've retrieved your properties. You have 3 properties in your portfolio: 'Evergreen Terrace' (ID: prop_1), 'Maple Street Apartments' (ID: prop_2), and 'Oak Lane' (ID: prop_3).
```

**Prompt:** 
```
Show the balance for tenant John Doe (ID 123).
```

**Response:** 
```
John Doe currently has a total balance of $1,250.00 due. His lease is active until December 31st, 2026.
```

**Prompt:** 
```
List the recent maintenance work orders.
```

**Response:** 
```
Retrieving work orders... There are 5 recent orders, including 'Fix Leaky Faucet' (Status: In Progress) and 'Repaint Unit 4B' (Status: New).
```

## Capabilities

### List all properties in the portfolio
Instantly pulls a complete list of every rental building you own or manage.

### Get specific property details
Retrieves detailed information for one particular unit, including its metadata and status.

### Check tenant records and balances
Accesses full profiles for any resident, showing their lease terms, payment history, and current balance due.

### Manage maintenance tasks and work orders
Queries the system to see what repairs are needed, who is assigned, and when they need to be finished.

### Access vendor and staff directories
Provides a list of all contracted vendors or internal personnel managed within your account.

## Use Cases

### A tenant calls asking about their overdue balance.
The agent uses `get_tenant` and then checks the financials. It tells you John Doe's exact total balance of $1,250.00 due, plus when his lease ends. No manual lookups needed.

### A maintenance issue needs coordinating with contractors.
You ask the agent to list all open work orders and check which vendors are available via `list_work_orders` and `list_vendors`. The agent tells you who's free next Tuesday.

### Need a quick inventory of vacant units.
You ask the agent to list all rental units, which then calls `list_units`, giving you an immediate count and status check on every unit in your portfolio.

## Benefits

- Stop searching through multiple dashboards. You can ask your agent to list all properties or pull a tenant's balance with one single request, eliminating the need for manual navigation.
- Keep maintenance moving without constant calls. Use `list_work_orders` and `list_tasks` to get an immediate status update on any repair job, whether it’s 'New' or 'In Progress'.
- Never lose track of who lives where. You can use `list_units` and then `get_unit` to confirm a specific unit's details immediately when speaking with a resident.
- Streamline vendor communication. Instantly access your directory using `list_vendors`, so you don't waste time looking up contact info in separate spreadsheets.
- See the big picture easily. Running `list_properties` gives you an immediate, accurate overview of your entire portfolio without having to generate a report first.

## How It Works

The bottom line is, once connected with your keys, your AI agent talks directly to Buildium’s database for you.

1. Subscribe to this MCP on Vinkius, then enter your Buildium Client ID and Client Secret.
2. Connect the credentials to any AI client—like Cursor or Claude—that supports the MCP standard.
3. Start talking to your agent. Just ask it what you need; it handles the rest.

## Frequently Asked Questions

**How do I list all my rental properties using the Buildium MCP?**
You ask your agent to use `list_properties`. It retrieves every property ID and name from your entire portfolio so you know exactly what's under management.

**Can I check a tenant's balance with the get_tenant tool?**
Yes. The `get_tenant` tool pulls up the full profile, including the exact outstanding financial balance and their current lease end date.

**What if I need to see all open repairs? Can list_work_orders handle that?**
Absolutely. The `list_work_orders` tool fetches a real-time log of maintenance work orders, letting you track status like 'New,' 'In Progress,' or 'Completed.' 

**How do I get details on a specific unit using the MCP?**
You use `get_unit`. Just give the agent the unit ID, and it pulls all associated metadata—like its square footage or last inspection date.

**Before I run any commands, what credentials do I need for this MCP, like when using list_properties?**
You must provide your Buildium Client ID and Client Secret. These are the keys that authenticate your connection to Buildium's system. You supply these through the Vinkius Marketplace setup process.

**If I need a full directory of all current tenants, should I use list_tenants instead of checking one tenant at a time?**
Yes, using list_tenants retrieves a comprehensive roster of every tenant record. This lets you quickly see who lives in your portfolio and check status details for many people at once.

**How do I get the full contact directory for external service providers using list_vendors?**
list_vendors pulls all approved vendors into a single, organized list. This is useful if you need to quickly cross-reference staff or contractors without checking multiple internal documents.

**I know the ID of a building; how do I get deep metadata about that specific property using get_property?**
get_property pulls detailed information beyond just basic listing data. It gives you core assets and settings, letting your AI client analyze specifics like tax details or zoning restrictions.

**Can I check the balance for a specific tenant using the agent?**
Yes! Use the `get_tenant` tool with the Tenant ID. Your agent will fetch the detailed profile, including the current total balance due.

**How do I list all the active maintenance tasks?**
Simply ask the agent to `list_tasks`. It will retrieve the current maintenance tasks from your Buildium account, including descriptions and status information.

**Does the integration allow creating a new work order?**
The current toolset focuses on querying and monitoring (Read-Only) for operational efficiency. Creating or updating work orders should be managed via the Buildium administrator portal.