MCP tools reference

DoorLoop MCP tools

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

MCP tool doorloop_list_properties

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

Parameters: list_properties
NameTypeDescription
search string Match on property name or address.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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

read

MCP tool doorloop_list_units

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

Parameters: list_units
NameTypeDescription
property_id string Only this property. Property ID from list_properties.
status enum all, occupied or vacant. Default: all.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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
}

MCP tool doorloop_list_tenants

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

Parameters: list_tenants
NameTypeDescription
search string Match on name, email or phone.
property_id string Only this property. Property ID from list_properties.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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
}

MCP tool doorloop_list_leases

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

Parameters: list_leases
NameTypeDescription
search string Match on unit or tenant name.
status enum active or ended. Default: active.
ends_before date Only leases ending on or before this date.
property_id string Only this property. Property ID from list_properties.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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
}

MCP tool doorloop_get_lease_transactions

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

Parameters: get_lease_transactions
NameTypeDescription
lease_id required string Lease ID from list_leases.
from date Start date. Default: lease start.
to date End date. Default: today.

tools/call

JSON-RPC

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

Example response

{
  "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

read

MCP tool doorloop_list_tasks

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

Parameters: list_tasks
NameTypeDescription
status string Only tasks with this status, as DoorLoop shows it.
property_id string Only this property. Property ID from list_properties.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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
}

MCP tool doorloop_list_communications

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

Parameters: list_communications
NameTypeDescription
since datetime Only entries sent after this time.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

{
  "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
}

MCP tool doorloop_create_tenant

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

Parameters: create_tenant
NameTypeDescription
first_name required string First name.
last_name required string Last name.
email string Email address.
phone string Phone number, E.164.

tools/call

JSON-RPC

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

Example response

{
  "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

write

MCP tool doorloop_create_task

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

Parameters: create_task
NameTypeDescription
subject required string Short title.
description string Details for whoever does the work.
property_id string Only this property. Property ID from list_properties.
unit_id string Unit it concerns.
due_date date Due date.

tools/call

JSON-RPC

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

Example response

{
  "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

write Confirm

MCP tool doorloop_create_lease

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

Parameters: create_lease
NameTypeDescription
unit_id required string Unit ID from list_units.
tenant_ids required string[] Tenant IDs from list_tenants or create_tenant.
start_date required date First day of the lease.
end_date date Last day. Leave empty for month-to-month.
rent required object amount and due_day of the recurring rent charge.
security_deposit object amount and due_date.

tools/call

JSON-RPC

{
  "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

{
  "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

write Confirm

MCP tool doorloop_post_lease_charge

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

Parameters: post_lease_charge
NameTypeDescription
lease_id required string Lease ID from list_leases.
amount required string Decimal amount, e.g. "50.00".
date required date Charge date.
account required string Income account, as named in your DoorLoop chart of accounts.
memo string Shown on the ledger.

tools/call

JSON-RPC

{
  "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

{
  "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

write Confirm

MCP tool doorloop_record_lease_payment

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

Parameters: record_lease_payment
NameTypeDescription
lease_id required string Lease ID from list_leases.
amount required string Decimal amount received.
date required date Date received.
method required string Payment method as DoorLoop lists it, e.g. check or cash.
reference string Check number or other reference.

tools/call

JSON-RPC

{
  "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

{
  "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

write Confirm

MCP tool doorloop_issue_lease_credit

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

Parameters: issue_lease_credit
NameTypeDescription
lease_id required string Lease ID from list_leases.
amount required string Decimal amount.
date required date Credit date.
memo string Reason, shown on the ledger.

tools/call

JSON-RPC

{
  "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

{
  "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

write Confirm

MCP tool doorloop_send_announcement

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

Parameters: send_announcement
NameTypeDescription
subject required string Announcement title.
body required string Message text.
property_ids string[] Only tenants in these properties. Default: all.
channels required string[] Any of email, text, portal.

tools/call

JSON-RPC

{
  "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

{
  "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
}