17hats MCP server Let your AI agent do the 17hats admin.

ToolWhat it doesAccess

• list_contacts Contacts by type (hot lead, client, cold prospect), searchable by name or email. read

  Returns contacts with ID, type, email, phone and their projects.

  MCP call17hats_read → list_contacts

  REST endpointGET https://cotlet.dev/api/v1/17hats/contacts

  Parameters

  Parameters: list_contacts

  Name	Type	Description
  query string	string	Name or email.
  type string	string	Hot Lead, Client, Cold Prospect, Other.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "contacts": [
      {
        "contact_id": "CT-77120",
        "name": "Megan Alvarez",
        "type": "Hot Lead",
        "email": "megan@example.com",
        "projects": 1
      }
    ],
    "page": 1
  }

• add_contact Adds a contact, for example a new lead. write

  Creates the contact with type and details. Reaches no one, so it runs at once.

  MCP call17hats_write → add_contact

  REST endpointPOST https://cotlet.dev/api/v1/17hats/contacts

  Parameters

  Parameters: add_contact

  Name	Type	Description
  name string required	string	Full name.
  email string	string	Email.
  phone string	string	Phone.
  type string	string	Hot Lead, Client, Cold Prospect, Other. Default: Hot Lead.
  note string	string	What they asked for.

  Example input

  {
    "name": "Tyler Brennan",
    "email": "tyler@example.com",
    "type": "Hot Lead",
    "note": "Headshots, early December"
  }

  Example response

  {
    "contact_id": "CT-77188",
    "name": "Tyler Brennan",
    "type": "Hot Lead"
  }

• list_projects Projects with status, date, amount due and open to-dos. read

  Returns projects with contact, event date, status, unpaid invoice total and the next to-do.

  MCP call17hats_read → list_projects

  REST endpointGET https://cotlet.dev/api/v1/17hats/projects

  Parameters

  Parameters: list_projects

  Name	Type	Description
  status string	string	Lead, Booked, Completed.
  date_from string	string	ISO date.
  date_to string	string	ISO date.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "projects": [
      {
        "project_id": "PJ-4410",
        "contact": "Megan Alvarez",
        "name": "Alvarez family session",
        "date": "2026-11-22",
        "status": "Booked",
        "due": "350.00",
        "next_todo": "Send prep guide"
      }
    ],
    "page": 1
  }

• create_project Creates a project for a contact, with a workflow if you use one. write

  Creates the project and applies the workflow you name. Workflow steps that email the client follow your workflow settings. Reaches no one by itself, so it runs at once.

  MCP call17hats_write → create_project

  REST endpointPOST https://cotlet.dev/api/v1/17hats/contacts/{contact_id}/projects

  Parameters

  Parameters: create_project

  Name	Type	Description
  contact_id string required	string	Contact ID from list_contacts.
  name string required	string	Project name.
  date string	string	ISO event date.
  workflow string	string	Workflow name.

  Example input

  {
    "contact_id": "contact_8c41d2",
    "name": "Jane Doe"
  }

  Example response

  {
    "project_id": "PJ-4433",
    "contact": "Tyler Brennan",
    "name": "Brennan headshots",
    "date": "2026-12-02",
    "status": "Lead"
  }

• list_todos Your to-dos due today or overdue, by project. read

  Returns to-dos from workflows and your own list, with project and due date.

  MCP call17hats_read → list_todos

  REST endpointGET https://cotlet.dev/api/v1/17hats/todos

  Parameters

  Parameters: list_todos

  Name	Type	Description
  due_by string	string	ISO date. Default: today.

  Example response

  {
    "todos": [
      {
        "title": "Send prep guide",
        "project": "Alvarez family session",
        "due": "2026-11-09"
      }
    ]
  }

ToolWhat it doesAccess

• send_quote Creates and sends a quote on a project. writeasks first

  Builds the quote from your items or a template and emails it to the client to accept. By default you confirm each call; you can switch that off for this tool.

  MCP call17hats_write → send_quote

  REST endpointPOST https://cotlet.dev/api/v1/17hats/projects/{project_id}/quotes

  Parameters

  Parameters: send_quote

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.
  items array required	array	Item name, quantity, price.
  template string	string	Quote template name.

  Example input

  {
    "project_id": "project_8c41d2",
    "items": "items"
  }

  Example response

  {
    "quote_id": "Q-2219",
    "project": "Brennan headshots",
    "total": "450.00",
    "status": "Sent"
  }

• send_contract Sends a contract from your templates for signing. writeasks first

  Fills the contract template for the project and emails it for the client's signature. By default you confirm each call; you can switch that off for this tool.

  MCP call17hats_write → send_contract

  REST endpointPOST https://cotlet.dev/api/v1/17hats/projects/{project_id}/contracts

  Parameters

  Parameters: send_contract

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.
  template string required	string	Contract template name.

  Example input

  {
    "project_id": "project_8c41d2",
    "template": "template"
  }

  Example response

  {
    "contract_id": "K-1180",
    "project": "Brennan headshots",
    "template": "Portrait session agreement",
    "status": "Sent"
  }

• send_invoice Creates and sends an invoice on a project. writeasks first

  Creates the invoice, with a payment schedule if you give one, and emails it with the payment link. Your automatic reminders then apply. By default you confirm each call; you can switch that off for this tool.

  MCP call17hats_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/17hats/projects/{project_id}/invoices

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.
  items array required	array	Item name, quantity, price.
  due string	string	ISO due date.

  Example input

  {
    "project_id": "project_8c41d2",
    "items": "items"
  }

  Example response

  {
    "invoice_id": "INV-6031",
    "project": "Brennan headshots",
    "total": "450.00",
    "status": "Sent"
  }

• record_payment Records a payment made outside 17hats. writeasks first

  Marks the amount paid on the invoice, for example a check or bank transfer, so reminders stop. By default you confirm each call; you can switch that off for this tool.

  MCP call17hats_write → record_payment

  REST endpointPOST https://cotlet.dev/api/v1/17hats/invoices/{invoice_id}/payments

  Parameters

  Parameters: record_payment

  Name	Type	Description
  invoice_id string required	string	Invoice ID.
  amount number required	number	Amount paid.
  method string	string	Check, cash, bank transfer.

  Example input

  {
    "invoice_id": "invoice_8c41d2",
    "amount": 1
  }

  Example response

  {
    "invoice_id": "INV-6012",
    "paid": "350.00",
    "balance": "0.00"
  }