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

# MCP setup & use

> Connect your AI tools to Fabric. Search, save, and manage your Fabric links and notes from Claude Code, Cursor, Windsurf, and other MCP-compatible tools.

***

## Overview

Fabric's MCP server lets AI coding assistants and other tools access your saved links, files, and notes. It supports the standard [**<u>Model Context Protocol</u>**](https://modelcontextprotocol.io/) with OAuth authentication — just add the server URL and your tool handles the rest.

***

## Use Fabric directly from ChatGPT, Claude and other MCP-compatible tools.

Fabric now has MCP support to perform the following actions:

**Files, notes and workspace:**

* Item search
* Create a note
* Create a bookmark
* Create a folder
* Edit a note
* Delete an item
* Get markdown body of a note
* Move an item
* Rename an item

**Fabric Memory:**

* Create memory
* Edit memory
* Delete memory
* List memories
* Manage memories
* Search memories

**Tagging:**

* Create tags
* Edit tags
* Apply/remove tags
* Search tags

**Tasks:**

* Create task
* Edit task
* Delete task
* List all tasks

***

## Getting started

Add this server URL to your MCP client:

```text theme={null}
https://mcp.api.fabric.so/mcp
```

Most MCP clients support "remote" or "URL-based" servers. Add the URL above, and the client will handle OAuth authentication automatically — you'll be prompted to authorize through your browser the first time you connect.

***

## App setup

### Claude Code

Run this command in your terminal:

```text theme={null}
claude mcp add fabric --transport http https://mcp.api.fabric.so/mcp
```

Then restart Claude Code. You'll be prompted to authorize through your browser on first use.

### Claude Desktop

Go to **Settings** → **Connectors** → **Add custom connector**. Enter a name for the connector, and the URL `https://mcp.api.fabric.so/mcp` and follow the OAuth prompts.

### Cursor

Go to **Cursor Settings** → **MCP** → **Add new MCP Server**. Set the type to "URL" and enter `https://mcp.api.fabric.so/mcp`.

### Windsurf

Follow Windsurf's MCP configuration guide. Add a new server with URL `https://mcp.api.fabric.so/mcp`.

### Codex

Run this command in your terminal:

```text theme={null}
codex mcp add fabric --url https://mcp.api.fabric.so/mcp
```

### VS Code / Copilot

Add to your MCP settings (`.vscode/mcp.json` or user settings):

```text theme={null}
{
  "servers": {
    "fabric": {
      "type": "http",
      "url": "https://mcp.api.fabric.so/mcp"
    }
  }
}
```

### ChatGPT

Go to **Settings** → **Connectors** → **Add Connector**. Enter the URL `https://mcp.api.fabric.so/mcp`, give it a name, and save. Then start a new conversation, click **More** → **Add Connectors**, and select Fabric. You'll be prompted to authorize on first use.

### Other MCP clients

Any MCP client that supports remote/HTTP servers can connect. Use the server URL `https://mcp.api.fabric.so/mcp`. The client will discover the OAuth configuration automatically via the `.well-known/oauth-authorization-server` metadata endpoint.

***

## Available tools

| **Tool**               | **Description**                                                             |
| :--------------------- | :-------------------------------------------------------------------------- |
| fabric-create-bookmark | Create a bookmark in Fabric                                                 |
| fabric-create-folder   | Creates a Fabric folder                                                     |
| fabric-create-memory   | Creates a Fabric memory                                                     |
| fabric-create-note     | Creates a Fabric note                                                       |
| fabric-create-task     | Creates a Fabric task                                                       |
| fabric-delete-item     | Deletes a Fabric item (file, note, link, etc.)                              |
| fabric-delete-task     | Deletes a Fabric task                                                       |
| fabric-edit-memory     | Edits a Fabric memory object                                                |
| fabric-edit-notepad    | Edits a Fabric note                                                         |
| fabric-edit-task       | Edits a Fabric task                                                         |
| fabric-find-items      | Search your saved links, files and notes by keyword and semantic similarity |
| fabric-list-memories   | Lists Fabric memories                                                       |
| fabric-list-tasks      | Lists Fabric tasks                                                          |
| fabric-move-items      | Moves Fabric items from one location to anther                              |
| fabric-read-item       | Reads contents of a Fabric item                                             |
| fabric-read-memory     | Reads contents of a Fabric memory                                           |
| fabric-rename-item     | Renames a Fabric item                                                       |
| fabric-search-memories | Searches your Fabric memories                                               |
| fabric-search-tags     | Searches your Fabric tags                                                   |

***

## Troubleshooting

### I'm having issues with authentication

* Your authentication status should automatically renew, but if for some reason this fails, you can try uninstalling and reinstalling the Fabric MCP server in the relevant service (for example, Claude).

### I'm having issues with creating items in Fabric

* If you cannot create further items in Fabric, you may be out of Fabric storage or AI usage – you can check your quotas [here](https://fabric.so/settings/usage). Your quota renews based on your plan, and you can top-up any time, if you want.

### It's not finding something in my Fabric

* If you can't find something, there are 2 likely causes:
  * It might still be being indexed for search, particularly if the content is large, or you have created/saved a large volume of content in a short period of time. Usually this process is very fast (fractions of a second), but if not yet, the best action is to wait.
  * You may have deleted that content. Deleted content (either in the bin, or permanently deleted) is not discoverable via search. If permanently deleted, the content no longer exists.
