# DoorLoop MCP tools

> Every DoorLoop MCP tool on the Cotlet server: tool names, input schemas, a tools/call example and an example result for each tool.

Source: https://cotlet.dev/docs/mcp/doorloop

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

14 tools for DoorLoop on the Cotlet MCP server. Your agent picks them from tools/list.

- MCP server: `https://cotlet.dev/mcp/v1`
- Connects with: Your own DoorLoop account (a user who can manage leases, payments and communications)
- Integration page: https://cotlet.dev/integrations/doorloop-api-mcp-server

## Endpoints

| Endpoint | Access | Description |
|---|---|---|
| `doorloop_list_properties` | read | Your properties with address, type and unit count. |
| `doorloop_list_units` | read | Units with property, rent and whether each is occupied or vacant. |
| `doorloop_list_tenants` | read | Tenants with email, phone, unit and current lease. |
| `doorloop_list_leases` | read | Leases with unit, tenants, rent, start and end dates and balance due. |
| `doorloop_get_lease_transactions` | read | Charges, payments and credits on a lease, oldest first, with the running balance. |
| `doorloop_list_tasks` | read | Tasks and work orders with status, due date, property and assignee. |
| `doorloop_list_communications` | read | The Communications Log: announcements and messages sent, with channel and delivery status. |
| `doorloop_create_tenant` | write | Add a tenant contact, ready to put on a lease. Sends nothing. |
| `doorloop_create_task` | write | New task or work order for a property or unit. |
| `doorloop_create_lease` | write | New lease on a unit with tenants, term, monthly rent and security deposit. |
| `doorloop_post_lease_charge` | write | One-time charge on a lease, such as a late fee. It shows on the tenant's balance. |
| `doorloop_record_lease_payment` | write | Record a payment received outside online payments and apply it to open charges. |
| `doorloop_issue_lease_credit` | write | Credit a lease, such as a rent concession, lowering the tenant's balance. |
| `doorloop_send_announcement` | write | Announcement to tenants by email, text or tenant portal. Texts use announcement credits. |

## List properties

MCP tool: `doorloop_list_properties`

Access: read.

Returns the properties in your DoorLoop account, with address and number of units. Search matches the property name or address. Use the property_id of each item in the other tools.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | no | Match on property name or address. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_properties",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "properties": [
      {
        "property_id": "pr_3a91c7",
        "name": "Maple Court",
        "address": "120 Maple St, Springfield",
        "type": "Multi-family",
        "units": 12
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## List units

MCP tool: `doorloop_list_units`

Access: read.

Returns units with the property they belong to and their occupancy. Filter by property or by occupied or vacant. Use unit_id from here in create_lease.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `property_id` | string | no | Only this property. Property ID from list_properties. |
| `status` | enum | no | all, occupied or vacant. Default: all. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_units",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "units": [
      {
        "unit_id": "un_5b20d4",
        "property": "Maple Court",
        "name": "Unit 4",
        "status": "vacant",
        "market_rent": "1600.00"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## List tenants

MCP tool: `doorloop_list_tenants`

Access: read.

Returns tenants with contact details and the lease they are on. Search matches name, email or phone. Use tenant_id from here in create_lease.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | no | Match on name, email or phone. |
| `property_id` | string | no | Only this property. Property ID from list_properties. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_tenants",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tenants": [
      {
        "tenant_id": "tn_91c0e7",
        "name": "Dana Reed",
        "email": "dana@example.com",
        "phone": "+15555550123",
        "unit": "Unit 4",
        "lease_id": null
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## List leases

MCP tool: `doorloop_list_leases`

Access: read.

Returns leases with the unit, the tenants on them, monthly rent, dates and the balance due. Filter by status, by end date or by property. Use lease_id from here in the other lease tools. Search matches unit or tenant name.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | no | Match on unit or tenant name. |
| `status` | enum | no | active or ended. Default: active. |
| `ends_before` | date | no | Only leases ending on or before this date. |
| `property_id` | string | no | Only this property. Property ID from list_properties. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_leases",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "leases": [
      {
        "lease_id": "ls_64f1a9c2",
        "unit": "Unit 2B",
        "property": "Maple Court",
        "tenants": [
          "Marcus Hale"
        ],
        "rent": "1450.00",
        "start_date": "2026-01-01",
        "end_date": "2026-12-31",
        "balance_due": "1450.00"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## Get lease transactions

MCP tool: `doorloop_get_lease_transactions`

Access: read.

Returns the ledger of one lease, oldest first: charges, payments and credits, each with a running balance. Use it to see whether a rent charge is still open before you add a fee or record a payment.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `lease_id` | string | yes | Lease ID from list_leases. |
| `from` | date | no | Start date. Default: lease start. |
| `to` | date | no | End date. Default: today. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_get_lease_transactions",
    "arguments": {
      "lease_id": "lease_8c41d2"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lease_id": "ls_64f1a9c2",
    "transactions": [
      {
        "type": "charge",
        "date": "2026-10-01",
        "description": "Rent October 2026",
        "amount": "1450.00",
        "balance": "1450.00"
      }
    ],
    "balance_due": "1450.00"
  },
  "isError": false
}
```

## List tasks

MCP tool: `doorloop_list_tasks`

Access: read.

Returns tasks and work orders, filtered by status or property. Each item has its subject, the property or unit it concerns, the due date and who it is assigned to.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | string | no | Only tasks with this status, as DoorLoop shows it. |
| `property_id` | string | no | Only this property. Property ID from list_properties. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_tasks",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tasks": [
      {
        "task_id": "tk_20c8",
        "subject": "Fix hallway light",
        "property": "Maple Court",
        "unit": null,
        "status": "open",
        "due_date": "2026-10-15",
        "assignee": "Sam Ortiz"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## List communications

MCP tool: `doorloop_list_communications`

Access: read.

Returns entries from the Communications Log, newest first, with the channel, subject and delivery status. Use it after send_announcement to see who the announcement reached.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `since` | datetime | no | Only entries sent after this time. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_list_communications",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "communications": [
      {
        "communication_id": "cm_77f0",
        "subject": "Water shutoff Thursday",
        "channel": "email",
        "sent_at": "2026-10-11T09:02:00Z",
        "delivery": "delivered",
        "recipients": 12
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## Create tenant

MCP tool: `doorloop_create_tenant`

Access: write.

Adds one tenant contact. It sends nothing to the tenant and attaches no charge. It runs without asking first, because it reaches no one and the contact can be deleted in DoorLoop.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `first_name` | string | yes | First name. |
| `last_name` | string | yes | Last name. |
| `email` | string | no | Email address. |
| `phone` | string | no | Phone number, E.164. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_create_tenant",
    "arguments": {
      "first_name": "first name",
      "last_name": "last name"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tenant_id": "tn_91c0e7",
    "name": "Dana Reed",
    "email": "dana@example.com",
    "status": "created"
  },
  "isError": false
}
```

## Create task

MCP tool: `doorloop_create_task`

Access: write.

Creates a task or work order with a subject, optional property or unit and a due date. It does not message anyone by itself. It runs without asking first, because it reaches no tenant and the task can be removed in DoorLoop.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `subject` | string | yes | Short title. |
| `description` | string | no | Details for whoever does the work. |
| `property_id` | string | no | Only this property. Property ID from list_properties. |
| `unit_id` | string | no | Unit it concerns. |
| `due_date` | date | no | Due date. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_create_task",
    "arguments": {
      "subject": "subject"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "task_id": "tk_20c9",
    "subject": "Replace smoke detector, Unit 2B",
    "property": "Maple Court",
    "due_date": "2026-10-18",
    "status": "created"
  },
  "isError": false
}
```

## Create lease

MCP tool: `doorloop_create_lease`

Access: write. Confirm: waits for the user's OK before it runs.

Creates a lease on one unit in a single step: tenants, term, recurring rent with its due day and an optional security deposit. Leave end_date empty for a month-to-month lease. The lease creates charges on the ledger. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `unit_id` | string | yes | Unit ID from list_units. |
| `tenant_ids` | string[] | yes | Tenant IDs from list_tenants or create_tenant. |
| `start_date` | date | yes | First day of the lease. |
| `end_date` | date | no | Last day. Leave empty for month-to-month. |
| `rent` | object | yes | amount and due_day of the recurring rent charge. |
| `security_deposit` | object | no | amount and due_date. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_create_lease",
    "arguments": {
      "unit_id": "un_5b20d4",
      "tenant_ids": [
        "tn_91c0e7"
      ],
      "start_date": "2026-11-01",
      "end_date": "2027-10-31",
      "rent": {
        "amount": "1600.00",
        "due_day": 1
      },
      "security_deposit": {
        "amount": "1600.00",
        "due_date": "2026-11-01"
      }
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lease_id": "ls_9e13b5",
    "unit": "Unit 4",
    "tenants": [
      "Dana Reed"
    ],
    "start_date": "2026-11-01",
    "end_date": "2027-10-31",
    "rent": {
      "amount": "1600.00",
      "due_day": 1
    },
    "security_deposit": {
      "amount": "1600.00",
      "due_date": "2026-11-01"
    },
    "status": "created"
  },
  "isError": false
}
```

## Post lease charge

MCP tool: `doorloop_post_lease_charge`

Access: write. Confirm: waits for the user's OK before it runs.

Adds one charge to a lease ledger, for example a late fee or a utility bill. It raises the balance due. It does not change your late fee policy. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `lease_id` | string | yes | Lease ID from list_leases. |
| `amount` | string | yes | Decimal amount, e.g. "50.00". |
| `date` | date | yes | Charge date. |
| `account` | string | yes | Income account, as named in your DoorLoop chart of accounts. |
| `memo` | string | no | Shown on the ledger. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_post_lease_charge",
    "arguments": {
      "lease_id": "lease_8c41d2",
      "amount": "50.00",
      "date": "2026-10-01",
      "account": "account"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "charge_id": "ch_41b7",
    "lease_id": "ls_64f1a9c2",
    "amount": "50.00",
    "date": "2026-10-11",
    "account": "Late Fees",
    "balance_due": "1500.00",
    "status": "posted"
  },
  "isError": false
}
```

## Record lease payment

MCP tool: `doorloop_record_lease_payment`

Access: write. Confirm: waits for the user's OK before it runs.

Records a payment on a lease, the same as Receive Payment in DoorLoop, and applies it to open charges. The response lists the charges it was applied to and the balance after. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `lease_id` | string | yes | Lease ID from list_leases. |
| `amount` | string | yes | Decimal amount received. |
| `date` | date | yes | Date received. |
| `method` | string | yes | Payment method as DoorLoop lists it, e.g. check or cash. |
| `reference` | string | no | Check number or other reference. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_record_lease_payment",
    "arguments": {
      "lease_id": "ls_64f1a9c2",
      "amount": "1450.00",
      "date": "2026-10-11",
      "method": "check",
      "reference": "1042"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "payment_id": "pm_8d2e71b0",
    "lease_id": "ls_64f1a9c2",
    "amount": "1450.00",
    "method": "check",
    "reference": "1042",
    "applied_to": [
      {
        "charge": "Rent October 2026",
        "amount": "1450.00"
      }
    ],
    "balance_due": "0.00"
  },
  "isError": false
}
```

## Issue lease credit

MCP tool: `doorloop_issue_lease_credit`

Access: write. Confirm: waits for the user's OK before it runs.

Adds a credit to a lease ledger, which lowers the balance due. Use the memo to record the reason. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `lease_id` | string | yes | Lease ID from list_leases. |
| `amount` | string | yes | Decimal amount. |
| `date` | date | yes | Credit date. |
| `memo` | string | no | Reason, shown on the ledger. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_issue_lease_credit",
    "arguments": {
      "lease_id": "lease_8c41d2",
      "amount": "amount",
      "date": "2026-10-01"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "credit_id": "cr_19a4",
    "lease_id": "ls_64f1a9c2",
    "amount": "100.00",
    "date": "2026-10-11",
    "balance_due": "1350.00",
    "status": "posted"
  },
  "isError": false
}
```

## Send announcement

MCP tool: `doorloop_send_announcement`

Access: write. Confirm: waits for the user's OK before it runs.

Sends an announcement to tenants of the full portfolio or of chosen properties. Email and portal posts are free. Text messages use announcement credits (1 per 160 characters) and are capped at 800 characters. Announcements need DoorLoop's Pro or Premium plan. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `subject` | string | yes | Announcement title. |
| `body` | string | yes | Message text. |
| `property_ids` | string[] | no | Only tenants in these properties. Default: all. |
| `channels` | string[] | yes | Any of email, text, portal. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "doorloop_send_announcement",
    "arguments": {
      "subject": "Water shutoff Thursday",
      "body": "Water will be off Thursday from 9:00 to 12:00 for pipe repairs.",
      "property_ids": [
        "pr_3a91c7"
      ],
      "channels": [
        "email",
        "text"
      ]
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "communication_id": "cm_77f0",
    "subject": "Water shutoff Thursday",
    "channels": [
      "email",
      "text"
    ],
    "recipients": 12,
    "status": "sent"
  },
  "isError": false
}
```