Claude Desktop

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.

1

Add 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.

Claude Settings

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:

JSON
{
    "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://cloud.appwrite.io/v1" // Optional
            }
        }
    }
}
Enable other MCP tools

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

2

Verify MCP tools

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.

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.

3

Test the integration

Enter a prompt to list all users in your Appwrite project.

List users in Appwrite project