Skip to main content
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: 
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: 
{
  "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: 
{
  "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: 
{
  "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: 
[mcp_servers.folk]
url = "https://mcp.folk.app/mcp"
Authenticate by running: 
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:
TransportURL
Streamable HTTPhttps://mcp.folk.app/mcp
Most MCP clients accept a JSON configuration. Use the format expected by your tool: 
{
  "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.