> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Linkly AI in Raycast

> Integrate your Linkly AI local knowledge base with Raycast AI, enabling the macOS productivity tool to search and read your private documents

## Prerequisites

* [Raycast](https://raycast.com) installed (requires Raycast Pro subscription to use AI features)
* [Linkly AI CLI](/docs/en/use-cli) installed (Raycast only supports Stdio transport, so the CLI is required)
* Linkly AI Desktop running with the MCP service active

## Configuration Steps

<Steps>
  <Step title="Open the MCP extension">In Raycast, search for **Install Server**, or go to **Raycast Store** to install the MCP extension (if not already installed).</Step>
  <Step title="Add Linkly AI">Run the **Install Server** command and fill in: - **Name**: `linkly-ai` - **Type**: `stdio` - **Command**: `linkly` - **Arguments**: `mcp`</Step>
  <Step title="Restart Raycast">After saving, fully quit and restart Raycast to apply the configuration.</Step>
</Steps>

<Note>Raycast currently **only supports Stdio transport** and does not support HTTP URL method. Therefore you must install Linkly AI CLI first, which acts as a bridge to communicate with the desktop app.</Note>

## Getting Started

Once configured, type `@linkly-ai` in Raycast AI Chat to invoke the tool, or ask questions directly and Raycast will automatically call Linkly AI's tools. For example:

* "Search my documents for content about product design"
* "@linkly-ai read my project readme"

## FAQ

<AccordionGroup>
  <Accordion title="Error: cannot find the linkly command">Raycast uses an independent PATH environment. Make sure `linkly` is installed in a standard path (such as `/usr/local/bin` or `/opt/homebrew/bin`). Run `which linkly` in the terminal to confirm the path, and make sure that path is in Raycast's PATH. After modifying PATH, you need to fully restart Raycast for changes to take effect.</Accordion>
  <Accordion title="Tool list is empty">Confirm that Linkly AI Desktop is running and the MCP service is active. Raycast connects to the CLI on every call, so the desktop app must be running.</Accordion>
</AccordionGroup>