appwrite.com
appwrite.com logo

Appwrite

Integrates with Appwrite's database functionality, enabling AI workflows to manage databases, define schemas, perform CR...

Created byApr 22, 2025

Appwrite MCP server

Overview

A Model Context Protocol server for interacting with Appwrite's API. This server provides tools to manage databases, users, functions, teams, and more within your Appwrite project.

Quick Links

  • Configuration
  • Installation
  • IDE Integration:
  • Local Development
  • Debugging

Configuration

Before launching the MCP server, you must setup an Appwrite project and create an API key with the necessary scopes enabled.
Create a .env file in your working directory and add the following:
Then, open your terminal and run the following command

Linux and MacOS

Windows

Command Prompt

PowerShell

Installation

Using uv (recommended)

When using `uv` no specific installation is needed. We will use `uvx` to directly run mcp-server-appwrite.

Using pip

Then run the server using

Command-line arguments

Both the uv and pip setup processes require certain arguments to enable MCP tools for various Appwrite APIs.
When an MCP tool is enabled, the tool's definition is passed to the LLM, using up tokens from the model's available context window. As a result, the effective context window is reduced. The default Appwrite MCP server ships with only the Databases tools (our most commonly used API) enabled to stay within these limits. Additional tools can be enabled by using the flags below.
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Usage with Claude Desktop

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, where you must add the following:
Note: 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.
Upon successful configuration, you should be able to see the server in the list of available servers in Claude Desktop.
Claude Desktop Config

Usage with [Cursor](https://www.cursor.com/)

Head to Cursor Settings > MCP and click on Add new MCP server. Choose the type as Command and add the command below to the Command field.
  • MacOS
  • Windows
Cursor Settings

Usage with [Windsurf Editor](https://codeium.com/windsurf)

Head to Windsurf Settings > Cascade > Model Context Protocol (MCP) Servers and click on View raw config. Update the mcp_config.json file to include the following:
Windsurf Settings

Local Development

Clone the repository

Install `uv`

  • Linux or MacOS
  • Windows (PowerShell)

Prepare virtual environment

First, create a virtual environment.
Next, activate the virtual environment.
  • Linux or MacOS
  • Windows

Run the server

Debugging

You can use the MCP inspector to debug the server.
Make sure your .env file is properly configured before running the inspector. You can then access the inspector at http://localhost:5173.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Appwrite MCP server

Overview

A Model Context Protocol server for interacting with Appwrite's API. This server provides tools to manage databases, users, functions, teams, and more within your Appwrite project.

Quick Links

  • Configuration
  • Installation
  • IDE Integration:
  • Local Development
  • Debugging

Configuration

Before launching the MCP server, you must setup an Appwrite project and create an API key with the necessary scopes enabled.
Create a .env file in your working directory and add the following:
Then, open your terminal and run the following command

Linux and MacOS

Windows

Command Prompt

PowerShell

Installation

Using uv (recommended)

When using `uv` no specific installation is needed. We will use `uvx` to directly run mcp-server-appwrite.

Using pip

Then run the server using

Command-line arguments

Both the uv and pip setup processes require certain arguments to enable MCP tools for various Appwrite APIs.
When an MCP tool is enabled, the tool's definition is passed to the LLM, using up tokens from the model's available context window. As a result, the effective context window is reduced. The default Appwrite MCP server ships with only the Databases tools (our most commonly used API) enabled to stay within these limits. Additional tools can be enabled by using the flags below.
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Usage with Claude Desktop

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, where you must add the following:
Note: 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.
Upon successful configuration, you should be able to see the server in the list of available servers in Claude Desktop.
Claude Desktop Config

Usage with [Cursor](https://www.cursor.com/)

Head to Cursor Settings > MCP and click on Add new MCP server. Choose the type as Command and add the command below to the Command field.
  • MacOS
  • Windows
Cursor Settings

Usage with [Windsurf Editor](https://codeium.com/windsurf)

Head to Windsurf Settings > Cascade > Model Context Protocol (MCP) Servers and click on View raw config. Update the mcp_config.json file to include the following:
Windsurf Settings

Local Development

Clone the repository

Install `uv`

  • Linux or MacOS
  • Windows (PowerShell)

Prepare virtual environment

First, create a virtual environment.
Next, activate the virtual environment.
  • Linux or MacOS
  • Windows

Run the server

Debugging

You can use the MCP inspector to debug the server.
Make sure your .env file is properly configured before running the inspector. You can then access the inspector at http://localhost:5173.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.