Learn how you can add the Appwrite MCP servers to Cursor 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 Cursor Settings page, head to the MCP tab, and click on the Add new global MCP server button. This will open an mcp.json
file in your editor.
Choose which MCP server you want to configure:
Update the mcp.json
file to include the API server:
{
"mcpServers": {
"appwrite-api": {
"command": "uvx",
"args": [
"mcp-server-appwrite",
"--users"
],
"env": {
"APPWRITE_API_KEY": "your-api-key",
"APPWRITE_PROJECT_ID": "your-project-id",
"APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"
}
}
}
}
Configuration:
- Replace
your-project-id
with your actual Appwrite project ID - Replace
your-api-key
with your Appwrite API key - Replace
<REGION>
with your Appwrite Cloud region (e.g.,nyc
,fra
)
Update the mcp.json
file to include the docs server:
{
"mcpServers": {
"appwrite-docs": {
"url": "https://mcp-for-docs.appwrite.io",
"headers": {}
}
}
}
You can also directly add the MCP servers to Cursor using the following links:
Once you save the details, Cursor will connect with the MCP server(s) and load all available tools. You may need to restart Cursor if it is unable to start the MCP server.
Enable other API MCP tools
To enable additional API tools, learn more about command-line arguments.
Open Cursor Agent 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 project
List all databases in my project
Show me the collections in my database
Create a new document in my collection
Delete a specific user by ID
Example prompts:
How do I set up real-time subscriptions in Appwrite?
Show me how to authenticate users with OAuth
What are the best practices for database queries?
How do I implement file uploads with Appwrite Storage?
Show me an example of using Appwrite Functions