Skip to main content

MCP Server

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Follow data securely.

Connect to our MCP server natively in Claude, Cursor, and other clients, or use the mcp-remote module for backwards compatibility with clients that do not support remote MCP.

Follow's MCP server follows the authenticated remote MCP spec, so the server is centrally hosted and managed. The server has tools available for managing locations, monitoring stations, controlling locks, listing access codes, and tracking usage, with more functionality on the way. Feedback on its functionality is welcomed.

Setup instructions​

General​

Our MCP server supports Streamable HTTP transports. This transport uses OAuth 2.1 with PKCE for authentication at the following address:

https://mcp.follow.tech/mcp

For instructions for specific clients, read on...

Claude Desktop​

From Claude settings > Connectors, add a new connector with the URL https://mcp.follow.tech/mcp.

Alternatively, add the following to your configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "follow": {
      "url": "https://mcp.follow.tech/mcp"
    }
  }
}

Claude Code​

claude mcp add --transport http follow https://mcp.follow.tech/mcp

Then run /mcp once you've opened a Claude Code session to go through the authentication flow.

Cursor​

To add the MCP to Cursor, open Settings > MCP Servers and add a new server with the following configuration:

{
  "mcpServers": {
    "follow": {
      "url": "https://mcp.follow.tech/mcp"
    }
  }
}

Visual Studio Code​

CTRL/CMD + P and search for MCP: Add Server, then select Command (stdio) and enter:

npx mcp-remote https://mcp.follow.tech/mcp

Enter the name Follow and hit enter. Activate the server using MCP: List Servers, selecting Follow, then Start Server.

Alternatively, add the following to your .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "follow": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.follow.tech/mcp"]
      }
    }
  }
}

Windsurf​

  1. CTRL/CMD + , to open Windsurf settings.
  2. Scroll to Cascade > MCP servers.
  3. Select Add Server > Add custom server.
  4. Add the following:
{
  "mcpServers": {
    "follow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.follow.tech/mcp"]
    }
  }
}

Others​

Many other tools now support MCP servers. You can configure them to use Follow's MCP server with the following settings:

  • Command: npx
  • Arguments: -y mcp-remote https://mcp.follow.tech/mcp
  • Environment: None

FAQ​

What can the AI assistant do?

The MCP server gives the AI assistant tools to manage your locations, monitor station status and voltage, check lock states, unlock locks, list access codes and events, and track API usage. The assistant will discover the available tools automatically when connected.

Do I need a separate account?

No. You log in with your existing Follow credentials during the OAuth flow. Your account must have an ADMIN or OWNER role to access the MCP server.

Can the AI assistant unlock doors?

Yes, the unlock tool is available. The assistant will typically confirm before executing an unlock. This is a billed operation that counts against your API quota.

Why am I seeing an authentication error?

Try clearing cached auth info by running the following in your terminal:

rm -rf ~/.mcp-auth

Then reconnect. If the issue persists, make sure you are using a supported Node.js version (20+).

What happens if my session expires?

The MCP server automatically refreshes tokens when possible. If the session has fully expired, your AI client will prompt you to re-authenticate through the browser.

What's next?​