Lighthouse MCP Server

An MCP server that connects AI assistants (Claude, Cursor, etc.) to the Lighthouse CRM API.

Setup

1. Get your API key

Go to Settings → API Keys in Lighthouse and generate a key.

2. Configure your AI client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["-y", "@trylighthouse/mcp-server@latest"],
      "env": {
        "LIGHTHOUSE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add lighthouse -- npx -y @trylighthouse/mcp-server@latest

Set the env var: export LIGHTHOUSE_API_KEY=your-api-key

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "lighthouse": {
      "command": "npx",
      "args": ["-y", "@trylighthouse/mcp-server@latest"],
      "env": {
        "LIGHTHOUSE_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Records

Records support built-in types (company, person, deal) and custom object types (use the permalink as record_type).

| Tool | Description | |------|-------------| | lighthouse_crm_search_records | Search/filter records with CRM-style filters and sorting | | lighthouse_crm_get_record | Get a single record by ID | | lighthouse_crm_create_record | Create a new record | | lighthouse_crm_update_record | Update a record's fields | | lighthouse_crm_delete_record | Delete a record |

Attributes & Options

| Tool | Description | |------|-------------| | lighthouse_crm_get_attributes | List all field definitions for a record type | | lighthouse_crm_get_attribute | Get a single field definition | | lighthouse_crm_create_attribute | Create a custom field | | lighthouse_crm_update_attribute | Update a custom field | | lighthouse_crm_delete_attribute | Delete a custom field | | lighthouse_crm_get_color_palette | Get available colors for select options | | lighthouse_crm_list_options | List options for a select/status field | | lighthouse_crm_create_option | Create a field option | | lighthouse_crm_delete_option | Delete a field option |

Lists

| Tool | Description | |------|-------------| | lighthouse_crm_list_lists | Get all CRM lists | | lighthouse_crm_create_list | Create a new list | | lighthouse_crm_get_list | Get a single list | | lighthouse_crm_update_list | Update a list | | lighthouse_crm_delete_list | Delete a list | | lighthouse_crm_get_list_records | Get records in a list | | lighthouse_crm_add_to_list | Add a record to a list | | lighthouse_crm_remove_from_list | Remove a record from a list | | lighthouse_crm_share_list_with_teams | Share a list with teams | | lighthouse_crm_revoke_list_from_teams | Revoke team access to a list | | lighthouse_crm_update_list_sharing | Update list sharing scope |

Notes

Notes can be linked to multiple records at once (via the records map). After creation, use the link/unlink tools to add or remove associations.

| Tool | Description | |------|-------------| | lighthouse_crm_list_notes | List notes for a record | | lighthouse_crm_create_note | Create a note linked to one or more records | | lighthouse_crm_get_note | Get a single note | | lighthouse_crm_delete_note | Delete a note | | lighthouse_crm_link_note_record | Link an existing note to an additional record | | lighthouse_crm_unlink_note_record | Remove a note's link to a record |

Tasks

Tasks can be linked to any record type including custom objects. Use the permalink as the key in records (e.g., {"company": [ids], "news": [ids]}).

| Tool | Description | |------|-------------| | lighthouse_crm_list_tasks | List tasks with optional filtering and sorting | | lighthouse_crm_get_task | Get a single task | | lighthouse_crm_create_task | Create a task, optionally linked to records | | lighthouse_crm_update_task | Update a task | | lighthouse_crm_delete_task | Delete a task |

Files

| Tool | Description | |------|-------------| | lighthouse_crm_list_files | List files attached to a record | | lighthouse_crm_upload_file | Upload a file and attach it to a record | | lighthouse_crm_download_file | Download a file | | lighthouse_crm_delete_file | Delete a file |

Views

| Tool | Description | |------|-------------| | lighthouse_crm_list_views | List saved CRM views | | lighthouse_crm_get_view | Get a single view | | lighthouse_crm_update_view | Update a view | | lighthouse_crm_delete_view | Delete a view | | lighthouse_crm_share_view_with_teams | Share a view with teams | | lighthouse_crm_revoke_view_from_teams | Revoke team access to a view | | lighthouse_crm_update_view_sharing | Update view sharing scope |

Workspace

| Tool | Description | |------|-------------| | lighthouse_workspace_me | Get current authenticated user | | lighthouse_workspace_list_users | List workspace users | | lighthouse_workspace_get_user | Get a workspace user | | lighthouse_workspace_list_teams | List workspace teams | | lighthouse_workspace_get_team | Get a workspace team |

Discovery

| Tool | Description | |------|-------------| | lighthouse_discovery_get_attributes | Get discovery filter attributes | | lighthouse_discovery_search_companies | Search the company database | | lighthouse_discovery_search_investors | Search investors (VC funds, angels, etc.) | | lighthouse_discovery_search_organizations | Search non-profits, governments, and other organizations | | lighthouse_discovery_search_schools | Search schools and universities | | lighthouse_discovery_search_people | Search the people database | | lighthouse_discovery_lookup_by_domain | Look up companies by domain | | lighthouse_discovery_lookup_by_linkedin | Look up companies by LinkedIn URL | | lighthouse_discovery_lookup_people_by_linkedin | Look up people by LinkedIn URL | | lighthouse_discovery_get_saved_searches | List saved discovery searches | | lighthouse_discovery_get_search_results | Get results of a saved search | | lighthouse_discovery_get_locations | Get location filter options | | lighthouse_discovery_get_industries | Get industry filter options | | lighthouse_discovery_get_tags | Get tag filter options |

Reports & Dashboards

| Tool | Description | |------|-------------| | lighthouse_reports_list_dashboards | List dashboards | | lighthouse_reports_create_dashboard | Create a dashboard | | lighthouse_reports_get_dashboard | Get a dashboard | | lighthouse_reports_update_dashboard | Update a dashboard | | lighthouse_reports_delete_dashboard | Delete a dashboard | | lighthouse_reports_list_widgets | List widgets in a dashboard | | lighthouse_reports_create_widget | Create a widget | | lighthouse_reports_update_widget | Update a widget | | lighthouse_reports_delete_widget | Delete a widget | | lighthouse_reports_get_widget_data | Get widget data | | lighthouse_reports_share_dashboard_with_teams | Share a dashboard with teams | | lighthouse_reports_revoke_dashboard_from_teams | Revoke team access to a dashboard |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | LIGHTHOUSE_API_KEY | Yes | Your Lighthouse API key | | LIGHTHOUSE_API_URL | No | Override API base URL (default: https://api.trylighthouse.vc) |