Skip to main content
Hyperspell lets agents search, answer, and learn from internal knowledge. It works across uploaded documents, integrations like Notion, Gmail, and Slack, and raw text input. It provides fast semantic retrieval, optional question-answering, and user-specific permissions. Let your users connect to multiple sources and use Hyperspell’s end-to-end data pipeline to get structured data with a single API call.

​
Description

Hyperspell provides agents with the ability to build and query internal knowledge using:
  • Cross-source search across documents, emails, Notion, Gmail, Slack, and many other integrations
  • Upload files and documents to create your agents’ memory
  • Answering questions requiring multiple documents

​
Installation

Create your Hyperspell app and get your API key from the Hyperspell Dashboard. Follow the instructions to connect your data sources Set the environment variables in your project’s .env file:
Hyperspell is a multi-tenant platform, and you can separate your data by use by setting the user id of your end-user in a variable too:

​
Available Functions

The Hyperspell tool provides three core functions for knowledge retrieval and ingestion:

​
Query documents

Search across your Hyperspell-connected sources for relevant information. Parameters:
​
string
required
The search query to find relevant information
​
string
required
Comma-separated list of sources to search (e.g., collections,notion,gmail)
​
bool
default:"False"
If True, returns a direct AI answer instead of just documents. Defaults to False
​
string
User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var

​
Add documents

Add a text document to your Hyperspell knowledge base. Parameters:
​
string
required
The full text content to add
​
string
required
Optional title for the document
​
string
Optional collection name to organize the document
​
string
User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var

​
Upload files

Upload a file (PDF, Word doc, spreadsheet, etc.) to your Hyperspell knowledge base. Parameters:
​
string
required
Path to the file to upload
​
string
Optional collection name to organize the document
​
string
User ID to use for this request. Defaults to HYPERSPELL_USER_ID env var
If no user_id is provided, the tool defaults to the HYPERSPELL_USER_ID environment variable.

​
Integration Sources

Hyperspell can search across multiple integrated sources:
  • Collections: Your uploaded documents and added text
  • Notion: Connected Notion workspaces
  • Gmail: Connected Gmail accounts
  • Slack: Connected Slack workspaces
  • and many more: Additional integrations available through the Hyperspell platform
For detailed integration setup, visit the Hyperspell documentation.