SurfSense DocsConnectors
Connect SurfSense to your tools and services
Connectors bring data into SurfSense — either as searchable knowledge or as live tools the AI agent can use during chat. There are two kinds:
Native Connectors
SurfSense's built-in scraper APIs: Reddit, YouTube, Google Maps, Google Search, and Web Crawl — usable in chat, the API Playground, or via REST
External Connectors
Third-party integrations: Notion, Slack, Linear, Jira, Google, GitHub, Obsidian, and more
How connectors surface in SurfSense
- Native scrapers — the AI agent uses them as tools automatically in chat, and you can run them yourself from the API Playground or your own code via the REST API.
- Tools & Live Sources — external connectors like Notion, Slack, Jira, or Linear give the agent real-time tools. Ask a question in chat and the agent searches or acts on the connected service directly; nothing is copied into SurfSense in the background.
- Knowledge Base — file sources like Google Drive, OneDrive, and Dropbox are imported through the Documents sidebar's Import menu and indexed into your knowledge base alongside uploads and notes.
To manage external connectors, open the Connectors dialog inside your workspace. Connected accounts, sync status, and disconnect options all live there.
Deprecated connectors
Some older connectors (Discord, Microsoft Teams, Luma, Elasticsearch, the old web crawler, and standalone search APIs) have been retired. Existing connections remain manageable, but new ones can't be added. Their docs are kept for reference under Deprecated. Public web search and crawling are now built in as native scrapers, and other search APIs can still be wired up through a custom MCP server.