|
| 1 | +--- |
| 2 | +layout: integration |
| 3 | +title: MCP with Cursor |
| 4 | +description: Connect to Appwrite project with the MCP within Cursor. |
| 5 | +date: 2025-07-01 |
| 6 | +featured: true |
| 7 | +isPartner: true |
| 8 | +isNew: true |
| 9 | +cover: /images/integrations/mcp-cursor/cover.png |
| 10 | +category: mcp |
| 11 | +product: |
| 12 | + avatar: '/images/integrations/avatars/cursor.png' |
| 13 | + vendor: Cursor |
| 14 | + description: 'Cursor is an AI-powered code editor based on VS Code, designed for context-aware development and seamless collaboration with large language models.' |
| 15 | +platform: |
| 16 | + - 'Self-hosted' |
| 17 | + - 'Cloud' |
| 18 | +images: |
| 19 | + - /images/integrations/mcp-cursor/cover.png |
| 20 | + - /images/integrations/mcp-cursor/appwrite-api-key.png |
| 21 | + - /images/docs/mcp/cursor/cursor-create-user.png |
| 22 | +--- |
| 23 | + |
| 24 | +Cursor is an AI-powered code editor built on VS Code, designed to enhance developer workflows with intelligent, context-aware assistance. It offers features like inline code generation, natural language explanations, and project-aware chat, enabling developers to prototype, debug, and refactor code faster with the help of integrated large language models such as Anthropic's Claude 4.0 Sonnet, Google's Gemini 2.5 Pro, and OpenAI's GPT-4.1. |
| 25 | + |
| 26 | +# How does the integration work? |
| 27 | + |
| 28 | +The Appwrite MCP server integrates with Cursor Agent using the Model Context Protocol (MCP), allowing you to connect your Appwrite project to Cursor. |
| 29 | + |
| 30 | +This integration enables you to perform various operations on your Appwrite resources, such as creating users, managing databases, and more, directly from the Cursor editor using natural language commands. |
| 31 | + |
| 32 | +# How to implement |
| 33 | + |
| 34 | +To implement the MCP with Cursor integration, there are several steps you must complete: |
| 35 | + |
| 36 | +## Step 1: Create an Appwrite API key |
| 37 | + |
| 38 | +First, you must [create an account on Appwrite Cloud](https://cloud.appwrite.io/register) or [self-host Appwrite](https://appwrite.io/docs/advanced/self-hosting) if you haven't already. |
| 39 | + |
| 40 | +Select your project (or create a new one), and head to the **Overview** page from the left sidebar. Under the **Integrations** section, click on the **API Keys** tab, and then click on **Create API Key**. Select the scopes for whichever Appwrite services you want to work with, set the duration, and create the API key. You must then copy it for future usage. |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +Then, head to the **Settings** page from the left sidebar, and copy the **Project ID** and **API Endpoint** for future usage. |
| 45 | + |
| 46 | +## Step 2: Configure the MCP server on Cursor |
| 47 | + |
| 48 | +{% info title="Pre-requisite: Install uv" %} |
| 49 | + |
| 50 | +You must install [uv](https://docs.astral.sh/uv/getting-started/installation/) on your system to use the MCP server. |
| 51 | + |
| 52 | +{% /info %} |
| 53 | + |
| 54 | +To configure the MCP server on Cursor, head to the **Cursor Settings** page, navigate to the **MCP** tab, and click on **Add new global MCP server**. This will open the `mcp.json` file, where you must add the following: |
| 55 | + |
| 56 | +```json |
| 57 | +{ |
| 58 | + "mcpServers": { |
| 59 | + "appwrite": { |
| 60 | + "command": "uvx", |
| 61 | + "args": [ |
| 62 | + "mcp-server-appwrite", |
| 63 | + "--users" |
| 64 | + ], |
| 65 | + "env": { |
| 66 | + "APPWRITE_API_KEY": "<your-api-key>", |
| 67 | + "APPWRITE_PROJECT_ID": "<your-project-id>", |
| 68 | + "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1" |
| 69 | + } |
| 70 | + } |
| 71 | + } |
| 72 | +} |
| 73 | +``` |
| 74 | + |
| 75 | +This configuration will set up the MCP server to connect to your Appwrite project using the API key, project ID, and endpoint, which you must update before saving and exiting the file. |
| 76 | + |
| 77 | +You may have noticed the `--users` argument, which enables Cursor to interact with the Appwrite Users API. To enable other Appwrite services, you can add their respective [command-line arguments](/docs/tooling/mcp#command-line-arguments). |
| 78 | + |
| 79 | +Once you have updated and saved the `mcp.json` file, Cursor will connect with the Appwrite MCP server and load all available tools. You may need to restart Cursor if it is unable to start the MCP server. |
| 80 | + |
| 81 | +### Skip this step, directly add the server to Cursor |
| 82 | + |
| 83 | +Once you have understood how the Appwrite MCP server is configured in Cursor, you can skip this step by directly adding the MCP server using the following link. |
| 84 | + |
| 85 | +{% only_light %} |
| 86 | +{% cards %} |
| 87 | +{% cards_item href="https://cursor.com/install-mcp?name=appwrite&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItYXBwd3JpdGUgLS11c2VycyIsImVudiI6eyJBUFBXUklURV9BUElfS0VZIjoiPHlvdXItYXBpLWtleT4iLCJBUFBXUklURV9QUk9KRUNUX0lEIjoiPHlvdXItcHJvamVjdC1pZD4iLCJBUFBXUklURV9FTkRQT0lOVCI6Imh0dHBzOi8vPFJFR0lPTj4uY2xvdWQuYXBwd3JpdGUuaW8vdjEifX0%3D" title="Add to Cursor" image="/images/docs/mcp/logos/cursor-ai.svg" %} |
| 88 | +{% /cards_item %} |
| 89 | +{% /cards %} |
| 90 | +{% /only_light %} |
| 91 | + |
| 92 | +{% only_dark %} |
| 93 | +{% cards %} |
| 94 | +{% cards_item href="https://cursor.com/install-mcp?name=appwrite&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItYXBwd3JpdGUgLS11c2VycyIsImVudiI6eyJBUFBXUklURV9BUElfS0VZIjoiPHlvdXItYXBpLWtleT4iLCJBUFBXUklURV9QUk9KRUNUX0lEIjoiPHlvdXItcHJvamVjdC1pZD4iLCJBUFBXUklURV9FTkRQT0lOVCI6Imh0dHBzOi8vPFJFR0lPTj4uY2xvdWQuYXBwd3JpdGUuaW8vdjEifX0%3D" title="Add to Cursor" image="/images/docs/mcp/logos/dark/cursor-ai.svg" %} |
| 95 | +{% /cards_item %} |
| 96 | +{% /cards %} |
| 97 | +{% /only_dark %} |
| 98 | + |
| 99 | +This will automatically configure the MCP server, and you will only need to update your Appwrite API key, project ID, and endpoint. |
| 100 | + |
| 101 | +## Step 3: Test the integration |
| 102 | + |
| 103 | +Finally, you can test the integration by asking Cursor Agent to create a new user in your Appwrite project. |
| 104 | + |
| 105 | + |
| 106 | + |
| 107 | +# Read more about MCP with Cursor |
| 108 | + |
| 109 | +If you would like to learn more about MCP with Cursor, we have some resources that you should visit: |
| 110 | + |
| 111 | +- [Appwrite MCP documentation](/docs/tooling/mcp) |
| 112 | +- [What exactly is MCP, and why is it trending?](/blog/post/what-is-mcp) |
| 113 | +- [Download Cursor](https://www.cursor.com/) |
0 commit comments