Learn how you can add the Appwrite MCP servers to Windsurf Editor to interact with both the Appwrite API and documentation.
Before you begin, ensure you have the following pre-requisites installed on your system:
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.
Choose which MCP server you want to configure:
Update the mcp_config.json file to include the API server:
{
"mcpServers": {
"appwrite-api": {
"command": "uvx",
"args": [
"mcp-server-appwrite",
"--databases",
"--users"
],
"env": {
"APPWRITE_PROJECT_ID": "your-project-id",
"APPWRITE_API_KEY": "your-api-key",
"APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"
}
}
}
}
Configuration:
- Replace
your-project-idwith your actual Appwrite project ID - Replace
your-api-keywith your Appwrite API key - Replace
<REGION>with your Appwrite Cloud region (e.g.,nyc,fra)
Update the mcp_config.json file to include the docs server:
{
"mcpServers": {
"appwrite-docs": {
"serverUrl": "https://mcp-for-docs.appwrite.io"
}
}
}
Once you save the details, head back to the MCP Servers section in the Windsurf Settings and click on the Refresh button.
Enable other API MCP tools
To enable additional API tools, learn more about command-line arguments.
Open Cascade chat in the Windsurf Editor and test your MCP integrations. You can try out the following example prompts based on the MCP server you have configured:
Example prompts:
Create a new user in my Appwrite projectList all databases in my projectShow me the collections in my databaseCreate a new document in my collectionDelete a specific user by ID
Example prompts:
How do I set up real-time subscriptions in Appwrite?Show me how to authenticate users with OAuthWhat are the best practices for database queries?How do I implement file uploads with Appwrite Storage?Show me an example of using Appwrite Functions
