AppWrite MCP Server
About
# AppWrite MCP Server [](https://nextjs.org/) [](https://reactjs.org/) [](https://www.typescriptlang.org/) [
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AppWrite MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18+ or Bun
- An Appwrite account and project
- Appwrite database and collection setup
Using npm:
npm install
Using bun (recommended):
bun install
Create a .env file in the root directory:
APPWRITE_ENDPOINT=https://YOURID.cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=YOUR-PROJECT-ID
APPWRITE_API_KEY=YOUR-API-KEY
DATABASE_ID=YOUR-DB-ID
Replace the placeholder values with your actual Appwrite credentials:
- APPWRITE_ENDPOINT: Your Appwrite instance endpoint
- APPWRITE_PROJECT_ID: Your Appwrite project ID
- APPWRITE_API_KEY: Your Appwrite API key (with database permissions)
- DATABASE_ID: Your Appwrite database ID
// Connect to the MCP server
mcp.connect('https://your-domain.com/mcp')
// List all documents
await mcp.listDocuments({ collectionId: 'company_names' })
// Create a new document
await mcp.createDocument({
company_name: 'Example Corp',
company_id: 12345
})
// Get a specific document
await mcp.getDocument({ documentId: 'doc_id_here' })
1. Create an Appwrite project
2. Create a database
3. Create a collection (e.g., 'company_names')
4. Set up the following attributes in your collection:
- company_name (string)
- company_id (integer)
5. Generate an API key with database permissions
6. Update your .env file with the credentials
To use this server with an MCP client, configure it with:
{
"server_url": "https://your-domain.com/mcp",
"capabilities": [
"database_operations",
"document_management"
]
}
The server provides 7 powerful database tools:
1. creatorInfo - Get detailed information about the creator
2. getDocument - Retrieve a document by its unique ID
3. listDocuments - List all documents from a collection
4. createDocument - Create new documents in the database
5. updateDocument - Update existing documents
6. deleteDocument - Delete documents from the database
7. clearCollection - Clear all documents from a collection
- ESLint - Code linting
- PostCSS - CSS processing
- Bun - Package manager and runtime
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"appwrite mcp server": {
"mcp-server-ramxcodes": {
"command": "bun",
"args": [
"dev"
]
}
}
}
}McpServers
{
"mcp-server-ramxcodes": {
"command": "bun",
"args": [
"dev"
]
}
}
A powerful Model Context Protocol (MCP) Server that provides seamless integration with Appwrite database operations. This project combines a beautiful, modern web interface with a robust MCP server for database interactions, built with Next.js 15, React 19, and the latest web technologies.
🌟 Features
- 🔥 MCP Server Integration: Full Model Context Protocol server implementation
- 🗄️ Database Operations: Complete CRUD operations for Appwrite databases
- ⚡ Lightning Fast: Optimized for speed with Next.js 15 and Turbo
- 🔒 Secure: Built with security best practices and type-safe operations
- 🎨 Beautiful UI: Modern, responsive interface with Tailwind CSS and Framer Motion
- 📱 Responsive Design: Fully responsive across all devices
- 🌙 Modern Stack: Next.js 15, React 19, TypeScript, and latest dependencies
Available MCP Tools
The server provides 7 powerful database tools:
1. creatorInfo - Get detailed information about the creator
2. getDocument - Retrieve a document by its unique ID
3. listDocuments - List all documents from a collection
4. createDocument - Create new documents in the database
5. updateDocument - Update existing documents
6. deleteDocument - Delete documents from the database
7. clearCollection - Clear all documents from a collection
🚀 Quick Start
Prerequisites
- Node.js 18+ or Bun
- An Appwrite account and project
- Appwrite database and collection setup
1. Clone the Repository
git clone https://github.com/ramxcodes/mcp-server.git
cd mcp-server
2. Install Dependencies
Using npm:
npm install
Using bun (recommended):
bun install
3. Environment Setup
Create a .env file in the root directory:
APPWRITE_ENDPOINT=https://YOURID.cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=YOUR-PROJECT-ID
APPWRITE_API_KEY=YOUR-API-KEY
DATABASE_ID=YOUR-DB-ID
Replace the placeholder values with your actual Appwrite credentials:
- APPWRITE_ENDPOINT: Your Appwrite instance endpoint
- APPWRITE_PROJECT_ID: Your Appwrite project ID
- APPWRITE_API_KEY: Your Appwrite API key (with database permissions)
- DATABASE_ID: Your Appwrite database ID
4. Run the Development Server
```bash
npm run dev
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
