Learn how you can add the Appwrite MCP server to Claude Desktop.
Pre-requisite: Install uv
You must install uv on your system to use the MCP server.
In the Claude Desktop app, open the app's Settings page (press CTRL + , on Windows or CMD + , on MacOS) and head to the Developer tab.
Clicking on the Edit Config button will take you to the claude_desktop_config.json file. In case the file is missing, please visit the Model Context Protocol docs.
After opening the file, add the following info:
{
"mcpServers": {
"appwrite": {
"command": "uvx",
"args": [
"mcp-server-appwrite",
"--users"
],
"env": {
"APPWRITE_PROJECT_ID": "your-project-id",
"APPWRITE_API_KEY": "your-api-key",
"APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"
}
}
}
}
If you are using the Claude Code CLI, you can use the following command in your terminal to configure the MCP server in the exact same manner:
claude mcp add-json appwrite '{"command":"uvx","args":["mcp-server-appwrite","--users"],"env":{"APPWRITE_PROJECT_ID": "your-project-id", "APPWRITE_API_KEY": "your-api-key", "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"}}'
Enable other MCP tools
To enable additional tools, learn more about command-line arguments.
Restart the Claude Desktop app, click on the MCP tools button (at the bottom right section of the prompt input) and click on it to view available Appwrite MCP tools.
uvx ENOENT error
In case you see a uvx ENOENT error, ensure that you either add uvx to the PATH environment variable on your system or use the full path to your uvx installation in the config file.
Enter a prompt to list all users in your Appwrite project.
