Qoyod MCP Server

A small MCP (Model Context Protocol) server that connects Claude directly to the Qoyod accounting software via their official REST API (https://api.qoyod.com/2.0).

After deploying it to any hosting, you get an HTTPS link like:

https://your-app.onrender.com/mcp

You add this link as a Custom Connector in Claude's settings, and Claude becomes able to read and create customers, invoices, vendors, journal entries, and other Qoyod resources — in any conversation, without needing to open the browser.

1) Available Tools

• qoyod_request — a general passthrough tool that covers any resource documented in apidoc.qoyod.com (Accounts, Products, Inventories, Vendors, Purchase Orders, Bills, Customers, Quotes, Invoices, Credit/Debit Notes, Receipts, Journal Entries...).

• Ready-to-use tools for quick access: qoyod_list_customers, qoyod_get_customer, qoyod_create_customer, qoyod_list_products, qoyod_list_invoices, qoyod_get_invoice, qoyod_create_invoice, qoyod_list_bills, qoyod_list_vendors, qoyod_list_journal_entries, qoyod_create_journal_entry, qoyod_list_accounts.

Note: Qoyod's general documentation does not detail every field of every resource. When creating (create_*), verify the correct payload shape via apidoc.qoyod.com or first try via qoyod_request with test data.

Related MCP server: Piriod MCP Server

2) Running Locally (optional, for testing before deployment)

Requires Node.js 18 or later.

npm install
cp .env.example .env
# افتح .env وضع مفتاح الـ API الخاص بك من قيود (Settings > General Settings > API Key)
npm start

The server will run on http://localhost:3000/mcp.

3) Deploying to a Free Hosting — Example Using Render.com

1. Create a free account on render.com (or use your GitHub account to log in).

2. Upload this folder to a new GitHub repository (you can create an empty repository on github.com and then upload the files directly from the web interface if you're not familiar with git).

3. From the Render dashboard: New + → Web Service → choose the repository.

4. Settings:

   • Build Command: npm install

   • Start Command: npm start

   • Environment Variable: add QOYOD_API_KEY with your Qoyod API key as the value.

5. Click Deploy. After the build finishes, you'll get a link like: https://qoyod-mcp-server.onrender.com

6. The full MCP link you'll use in Claude is: https://qoyod-mcp-server.onrender.com/mcp

Other Alternatives

The same steps roughly apply to Railway, Fly.io, and Cloudflare Workers (requires a small adjustment to fit the Workers environment).

Note on Render's free plan: the server "sleeps" after a period of inactivity and needs ~30-50 seconds for the first request after idle. If you want an always-instant response, you need a paid plan or another hosting that doesn't put the service to sleep.

4) Connecting It to Claude

1. In Claude's settings, find the Connectors section → Add custom connector.

2. Paste the link: https://your-app.onrender.com/mcp

3. Save. After that, Qoyod tools will appear among Claude's available tools in any conversation where you enable this connector.

5) Security

• Your API key is stored only as an environment variable (QOYOD_API_KEY) on your hosting — it never appears in the code and is never sent to any other party.

• Do not share your /mcp link with anyone you don't trust; it grants full access to the associated Qoyod account (according to the key's permissions).

• If you suspect the key has leaked, go to Qoyod → General Settings → click Generate New Key to issue a new key that immediately invalidates the old one.