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

# Connecting to folk MCP

> Learn how to connect your AI tool to folk using MCP

This guide walks you through connecting your AI tool to folk using the Model Context Protocol (MCP). Once connected, your tool can read and write to your folk workspace based on your access and permissions.

folk MCP uses OAuth for authentication: the first time your tool uses a folk tool, you'll be prompted to sign in and authorize access to your workspace.

## Claude Code

Run this command in your terminal:

```bash theme={null}
claude mcp add --transport http folk https://mcp.folk.app/mcp
```

Then authenticate by running `/mcp` in Claude Code and following the OAuth flow.

## Cursor

Open Cursor Settings → MCP → Add new global MCP server.

Paste the following configuration:

```json theme={null}
{
  "mcpServers": {
    "folk": {
      "url": "https://mcp.folk.app/mcp"
    }
  }
}
```

Save and restart Cursor. When you use a folk tool for the first time, complete the OAuth flow to connect your workspace.

To share the folk MCP configuration with your team, create a `.cursor/mcp.json` file in your project root with the same configuration.

## VS Code (GitHub Copilot)

Create a `.vscode/mcp.json` file in your workspace:

```json theme={null}
{
  "servers": {
    "folk": {
      "type": "http",
      "url": "https://mcp.folk.app/mcp"
    }
  }
}
```

Open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and run **MCP: List Servers**. Start the folk server and complete the OAuth flow when prompted.

## Claude Desktop

Open Settings → Connectors. Click **Add Connector** and enter the URL:

```
https://mcp.folk.app/mcp
```

Complete the OAuth flow to connect your folk workspace.

## Windsurf

Open Windsurf Settings (`Cmd+,` on Mac) and search for MCP. Click **View raw config** to open `mcp_config.json` and add the folk server configuration:

```json theme={null}
{
  "mcpServers": {
    "folk": {
      "serverUrl": "https://mcp.folk.app/mcp"
    }
  }
}
```

Save and restart Windsurf. Complete the OAuth flow when prompted.

## ChatGPT

Go to **Settings → Connectors** (requires login). Click **Add Connector** and enter the URL:

```
https://mcp.folk.app/mcp
```

Complete the OAuth flow to connect your folk workspace.

## Codex

Add the folk server to your Codex configuration at `~/.codex/config.toml`:

```toml theme={null}
[mcp_servers.folk]
url = "https://mcp.folk.app/mcp"
```

Authenticate by running:

```bash theme={null}
codex mcp login folk
```

Complete the OAuth flow to connect your folk workspace.

## Other tools

If your AI tool isn't listed above but supports MCP, you can connect using the following endpoint:

| Transport       | URL                        |
| --------------- | -------------------------- |
| Streamable HTTP | `https://mcp.folk.app/mcp` |

Most MCP clients accept a JSON configuration. Use the format expected by your tool:

```json theme={null}
{
  "mcpServers": {
    "folk": {
      "url": "https://mcp.folk.app/mcp"
    }
  }
}
```

## Troubleshooting

### Authentication issues

* Make sure you complete the OAuth flow when prompted.
* Try disconnecting and reconnecting: look for a "Clear authentication" or "Disconnect" option in your tool's MCP settings.
* Check that you have the correct permissions in the folk workspace you're trying to access.

### My tool isn't listed here

Check your tool's documentation for how to add a remote MCP server. Most tools accept either a URL directly or a JSON configuration. If your tool doesn't support MCP yet, consider reaching out to the developers to request MCP support.

## What's next

Learn what you can do with folk MCP using the [tools we provide](/mcp/tools).