Lockii
Lockii
  • Docs
  • Changelog
  • Feature requests
  • Support portal
    • User MCP
    • Login with Lockii
    • Customer MCP
    • Lockii REST API
    • Booking API
Docs / API & MCP

User MCP

Connect AI tools like ChatGPT, Claude, and Cursor to manage your Lockii account via MCP.

Lockii User MCP

The User MCP (Model Context Protocol) server exposes the full Lockii REST API as MCP tools. Connect it to ChatGPT, Claude, Cursor, Continue, and other MCP clients to search bookings, manage inventory, run reports, and handle operational workflows on your behalf.

Configure in the app: Settings → Integrations → User MCP

MCP Server URL

https://dash.lockii.app/api/mcp/user

Add this URL as a custom MCP server in your AI client.

Authentication

User MCP supports two authentication methods:

OAuth (recommended)

When your MCP client supports OAuth, it will authenticate through your Lockii login. The server exposes standard OAuth discovery endpoints:

  • GET /api/mcp/user/.well-known/oauth-protected-resource
  • GET /api/mcp/user/.well-known/oauth-authorization-server
  • GET /api/mcp/user/.well-known/openid-configuration

Follow your MCP client's OAuth setup flow — it will redirect you to sign in to Lockii and authorize access.

API key (fallback)

Existing API keys continue to work during the OAuth migration. Send your key as:

Method Example
Header x-api-key: your_api_key
Query string ?api_key=your_api_key

Create and manage API keys in Settings → Integrations → API.

Available tools

Each MCP tool maps directly to a REST API endpoint. Tool names match the API action names — all 57 standard API actions are exposed as tools.

Bookings & payments

  • search_bookings, get_booking, createChangeRequest
  • manual_pickup_booking, manual_return_booking
  • refund_payment, send_payment_link

Customers

  • create_customer, update_customer, delete_customer
  • block_customer, unblock_customer
  • manually_verify_customer, generate_verification_link
  • search_customers, list_customers, get_customer, get_customer_page

Products & inventory

  • Products: create_product, update_product, delete_product, search_products, get_product
  • Categories: create_category, update_category, delete_category, list_categories, get_category
  • Stock: create_stock, update_stock, delete_stock, search_stock, list_stock, get_stock

Locations & pricing

  • create_location, update_location, list_locations, get_location
  • create_pricing_template, update_pricing_template, delete_pricing_template
  • search_pricing_templates, list_pricing_templates, get_pricing_template

Coupons, locks & trackers

  • create_coupon, update_coupon, archive_coupon, search_coupons, list_coupons, get_coupon
  • list_locks, search_locks
  • list_trackers, search_trackers, get_tracker

Inbox & reports

  • read_inbox — Read inbox notifications
  • query_reports — Query company reports

Connecting your MCP client

  1. Open your MCP client's server configuration
  2. Add a new HTTP/streamable MCP server
  3. Set the URL to https://dash.lockii.app/api/mcp/user
  4. Authenticate via OAuth or provide your API key
  5. The tools will appear in your AI assistant's tool list

Cursor

Add the server to your MCP configuration with the URL above. Use OAuth when prompted, or pass your API key in the headers.

ChatGPT & Claude

Use the custom MCP / connector setup in your workspace settings. OAuth is preferred where supported.

Permissions

User MCP runs with the same permissions as the authenticated user or API key:

  • All data is scoped to your company
  • Location-scoped users only access permitted locations
  • Write operations respect your role permissions

Related

  • Lockii REST API — direct HTTP access to the same endpoints
  • Customer MCP — limited MCP for customer-facing support tools
PrevCustomer Accounts
NextLogin with Lockii
Was this helpful?