Windsurf Editor

Learn how you can add the Appwrite MCP server to Windsurf Editor.

Pre-requisite: Install uv

You must install uv on your system to use the MCP server.

1

Add MCP server

Open the Windsurf Settings page, head to the Cascade tab, find the Model Context Protocol (MCP) Servers section, and click on the View raw config button.

Add MCP server

Update the mcp_config.json file to include the following:

JSON
{
  "mcpServers": {
    "appwrite": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite",
        "--databases",
        "--users"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "your-project-id",
        "APPWRITE_API_KEY": "your-api-key",
        "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional
      }
    }
  }
}

Once you save the details, head back to the MCP Servers section in the Windsurf Settings and click on the Refresh button.

Enable other MCP tools

To enable additional tools, learn more about command-line arguments.

2

Test the integration

Open Cascade chat in the Windsurf Editor and add a prompt to query the database.

Create user in Appwrite project