# VTiger MCP Server

A Model Context Protocol (MCP) server for VTiger CRM integration.

## Features

- List and describe VTiger modules
- Create, read, update, and delete records
- Query records with filters
- Search across modules
- Full authentication support

## Setup

1. Install dependencies:
```bash
pip install -e .
```

2. Copy `.env.example` to `.env` and configure your VTiger credentials:
```bash
cp .env.example .env
```

3. Update `.env` with your VTiger details:
- `VTIGER_URL`: Your VTiger CRM instance URL
- `VTIGER_USERNAME`: Your CRM login email
- `VTIGER_ACCESS_KEY`: Found in My Preferences → Access Key

## Usage

Run the MCP server:
```bash
vtiger-mcp-server
```

## Available Tools

- `vtiger_list_modules`: List all accessible modules
- `vtiger_describe_module`: Get module field definitions
- `vtiger_create_record`: Create new records
- `vtiger_get_record`: Retrieve specific records
- `vtiger_update_record`: Update existing records  
- `vtiger_delete_record`: Delete records
- `vtiger_query_records`: Query with SQL-like syntax
- `vtiger_search_records`: Search across modules