> ## 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>