{"_id":"@dannychirkov/salesdrive-mcp-server","name":"@dannychirkov/salesdrive-mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@dannychirkov/salesdrive-mcp-server","version":"0.1.0","description":"MCP server for SalesDrive CRM API - enables AI assistants to manage orders, products, and payments","main":"dist/server.js","types":"dist/server.d.ts","bin":{"salesdrive-mcp":"dist/cli/index.js"},"license":"Apache-2.0","author":{"name":"Danny Chirkov"},"repository":{"type":"git","url":"git+https://github.com/dannychirkov/salesdrive-api.git","directory":"packages/salesdrive-mcp-server"},"homepage":"https://github.com/dannychirkov/salesdrive-api#readme","bugs":{"url":"https://github.com/dannychirkov/salesdrive-api/issues"},"keywords":["salesdrive","mcp","model-context-protocol","ai","claude","crm"],"scripts":{"build":"tsc","start":"node dist/cli/index.js","dev":"ts-node src/cli/index.ts","test":"jest","type-check":"tsc --noEmit","clean":"rimraf dist"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@dannychirkov/salesdrive-api-client":"*","@dannychirkov/salesdrive-transport-fetch":"*"},"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","jest":"^29.7.0","@types/jest":"^29.5.11","ts-jest":"^29.1.1","ts-node":"^10.9.2","rimraf":"^5.0.5"},"engines":{"node":">=18.0.0"},"_id":"@dannychirkov/salesdrive-mcp-server@0.1.0","gitHead":"c71db20321b4850f9e586de442a4c05b07a37a70","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-GDr239l/L5gnRCjzJLQvEhfB470AxG1vMTPqytfrSNdnBS9oYdinnIDcdtg0KxS7CrnkTKfu7aGNVo+JgOS34w==","shasum":"93362629296a49e373fdd6f047527642c9b313ab","tarball":"https://registry.npmjs.org/@dannychirkov/salesdrive-mcp-server/-/salesdrive-mcp-server-0.1.0.tgz","fileCount":78,"unpackedSize":119550,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID/UAml47bL5KTnwDlh59/1Z9/OCHJ+3VbLtAw0+sY0/AiAiFVjIBI4rpi8sj6T41bWzHDj5GitDEqItt24D51cOyw=="}]},"_npmUser":{"name":"dannychirkov","email":"dannychirkov@gmail.com"},"directories":{},"maintainers":[{"name":"dannychirkov","email":"dannychirkov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/salesdrive-mcp-server_0.1.0_1768112108930_0.5070546480956053"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-11T06:15:08.850Z","0.1.0":"2026-01-11T06:15:09.082Z","modified":"2026-01-11T06:15:09.331Z"},"maintainers":[{"name":"dannychirkov","email":"dannychirkov@gmail.com"}],"description":"MCP server for SalesDrive CRM API - enables AI assistants to manage orders, products, and payments","homepage":"https://github.com/dannychirkov/salesdrive-api#readme","keywords":["salesdrive","mcp","model-context-protocol","ai","claude","crm"],"repository":{"type":"git","url":"git+https://github.com/dannychirkov/salesdrive-api.git","directory":"packages/salesdrive-mcp-server"},"author":{"name":"Danny Chirkov"},"bugs":{"url":"https://github.com/dannychirkov/salesdrive-api/issues"},"license":"Apache-2.0","readme":"# @dannychirkov/salesdrive-mcp-server\n\nMCP (Model Context Protocol) server for SalesDrive CRM. Enables AI assistants like Claude to manage orders, products, and payments in SalesDrive.\n\n## Installation\n\n### With npx (recommended)\n\nNo installation needed! Just configure your AI assistant:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesdrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dannychirkov/salesdrive-mcp-server\"],\n      \"env\": {\n        \"SALESDRIVE_API_KEY\": \"your-api-key\",\n        \"SALESDRIVE_BASE_URL\": \"https://your-account.salesdrive.me\"\n      }\n    }\n  }\n}\n```\n\n### Global installation\n\n```bash\nnpm install -g @dannychirkov/salesdrive-mcp-server\n```\n\nThen configure:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesdrive\": {\n      \"command\": \"salesdrive-mcp\",\n      \"env\": {\n        \"SALESDRIVE_API_KEY\": \"your-api-key\",\n        \"SALESDRIVE_BASE_URL\": \"https://your-account.salesdrive.me\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Environment Variable   | Description                                         | Required            |\n| ---------------------- | --------------------------------------------------- | ------------------- |\n| `SALESDRIVE_API_KEY`   | Your SalesDrive API key                             | Yes                 |\n| `SALESDRIVE_BASE_URL`  | Your account URL (e.g., https://demo.salesdrive.me) | Yes                 |\n| `SALESDRIVE_READ_ONLY` | Set to `true` to disable write operations           | No (default: false) |\n| `LOG_LEVEL`            | Logging level (debug, info, warn, error)            | No (default: info)  |\n\n### Read-Only Mode\n\nFor safety, you can run the server in read-only mode. This disables all write operations:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesdrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dannychirkov/salesdrive-mcp-server\"],\n      \"env\": {\n        \"SALESDRIVE_API_KEY\": \"your-api-key\",\n        \"SALESDRIVE_BASE_URL\": \"https://your-account.salesdrive.me\",\n        \"SALESDRIVE_READ_ONLY\": \"true\"\n      }\n    }\n  }\n}\n```\n\nIn read-only mode, the following tools are disabled:\n\n- `order_create`, `order_update`\n- `product_update`, `product_delete`\n- `payment_add`\n- `currency_update`\n- `category_update`, `category_delete`\n\n### Getting Your API Key\n\n1. Log in to your SalesDrive account\n2. Go to **Settings** → **General Settings and Integrations** → **Other Services** → **API**\n3. Generate or copy your API key\n\n## Available Tools\n\n### Order Tools\n\n| Tool           | Description              |\n| -------------- | ------------------------ |\n| `order_list`   | List orders with filters |\n| `order_create` | Create a new order       |\n| `order_update` | Update an existing order |\n\n### Product Tools\n\n| Tool             | Description                    |\n| ---------------- | ------------------------------ |\n| `product_update` | Add or update products (batch) |\n| `product_delete` | Delete products by ID          |\n\n### Category Tools\n\n| Tool              | Description              |\n| ----------------- | ------------------------ |\n| `category_update` | Add or update categories |\n| `category_delete` | Delete categories by ID  |\n\n### Payment Tools\n\n| Tool           | Description        |\n| -------------- | ------------------ |\n| `payment_add`  | Register a payment |\n| `payment_list` | List payments      |\n\n### Reference Tools\n\n| Tool                             | Description          |\n| -------------------------------- | -------------------- |\n| `reference_get_payment_methods`  | Get payment methods  |\n| `reference_get_delivery_methods` | Get delivery methods |\n| `reference_get_statuses`         | Get order statuses   |\n\n### Currency Tools\n\n| Tool              | Description           |\n| ----------------- | --------------------- |\n| `currency_get`    | Get currency rates    |\n| `currency_update` | Update currency rates |\n\n### Document Tools\n\n| Tool                 | Description           |\n| -------------------- | --------------------- |\n| `invoice_list`       | List invoices         |\n| `sales_invoice_list` | List sales invoices   |\n| `cash_order_list`    | List cash orders      |\n| `contract_list`      | List contracts        |\n| `check_list`         | List fiscal receipts  |\n| `act_list`           | List acts             |\n| `arrival_list`       | List product arrivals |\n\n## Example Prompts\n\nOnce configured, you can ask your AI assistant:\n\n- \"Show me the last 10 orders from SalesDrive\"\n- \"Create a new order for customer with phone 0501234567\"\n- \"Update order #123 status to completed\"\n- \"What payment methods are available?\"\n- \"Add a payment of 500 UAH to order #456\"\n- \"Update the USD exchange rate to 42 UAH\"\n- \"Show me all invoices for this month\"\n- \"List all contracts\"\n- \"Show product arrivals from last week\"\n\n## Claude Desktop Setup\n\n### macOS\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesdrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dannychirkov/salesdrive-mcp-server\"],\n      \"env\": {\n        \"SALESDRIVE_API_KEY\": \"your-api-key\",\n        \"SALESDRIVE_BASE_URL\": \"https://your-account.salesdrive.me\"\n      }\n    }\n  }\n}\n```\n\n### Windows\n\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"salesdrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dannychirkov/salesdrive-mcp-server\"],\n      \"env\": {\n        \"SALESDRIVE_API_KEY\": \"your-api-key\",\n        \"SALESDRIVE_BASE_URL\": \"https://your-account.salesdrive.me\"\n      }\n    }\n  }\n}\n```\n\n## Troubleshooting\n\n### \"API key is required\"\n\nMake sure `SALESDRIVE_API_KEY` is set in the environment configuration.\n\n### \"Base URL is required\"\n\nMake sure `SALESDRIVE_BASE_URL` is set. It should be your account's URL, like `https://mycompany.salesdrive.me`.\n\n### Rate Limiting\n\nSalesDrive has rate limits (10/min, 100/hr, 1000/day for list operations). If you hit limits, wait and try again.\n\n### Debug Mode\n\nSet `LOG_LEVEL=debug` to see detailed logs in stderr.\n\n## License\n\n[Apache License 2.0](../../LICENSE)\n","readmeFilename":"README.md","_rev":"1-41e61074d3ef17f653b3f9591a1f7ffe"}