How to Use the Zoho CRM (Full) MCP in Windsurf

Q: How do I search for an existing company using Zoho CRM (Full) and Windsurf?

You use the zohosearchaccounts tool. It returns the account name, industry, website, phone number, annual revenue, and owner. This is how you find the main business entity ID required to link contacts or deals.

Q: Can I check a lead's status with Zoho CRM (Full) using Windsurf?

Yes. The zohosearchleads tool finds prospective customers by name, email, or company. It returns the lead source, current lead status—like 'Not Contacted' or 'Junk Lead'—and who owns the record.

Q: What if I need to log a new customer contact? Zoho CRM (Full) and Windsurf?

You run zohocreatecontact. This tool lets you add name, email, phone, and crucially, link the contact directly to an existing account using its name. Contacts are for qualified individuals who are past the 'lead' stage.

Q: Which tools let me review recent activity in Zoho CRM (Full) with Windsurf?

The zoholistrecords tool lets you browse general overviews of any module, including Leads, Contacts, Accounts, and Deals. It returns records sorted by modification date so you know what's been worked on recently.

Automate complex sales cycles. Windsurf connects to Zoho CRM (Full) for autonomous, multi-step data management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zoho CRM (Full) MCP to Windsurf

Create your Vinkius account to connect Zoho CRM (Full) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Zoho CRM (Full) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build complete customer profiles

Need a full picture of a prospect? Cascade can chain actions to gather all necessary details. First, use `zoho_search_accounts` to find the main company record. Then, it pulls associated individuals using `zoho_search_contacts`. Finally, you can log internal context by calling `zoho_create_note`, linking the activity to that account or contact.

Process new sales opportunities

You've identified a potential client and need to track them through the funnel. The agent first runs `zoho_create_lead` to log the initial prospect details. Once qualified, it upgrades that data using `zoho_create_contact`. If they become an active customer, you can then create a new deal record with `zoho_create_deal`, setting the stage and amount for tracking.

Maintain activity history

A lot of meetings happen. Instead of manually updating records, let Cascade handle it. Use `zoho_list_records` to see a general overview of recent activities across modules like Deals or Accounts. If you need to document a specific call summary, the system executes `zoho_create_note`, attaching the meeting details using a parent ID.

Setup guide

Set up Zoho CRM (Full) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Zoho CRM (Full) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Zoho CRM (Full) payment history." If connected, Cascade will call the Zoho CRM (Full) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "zoho-crm-full-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zoho CRM. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Zoho CRM (Full) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Zoho CRM (Full) MCP in Windsurf

You use the `zoho_search_accounts` tool. It returns the account name, industry, website, phone number, annual revenue, and owner. This is how you find the main business entity ID required to link contacts or deals.

Yes. The `zoho_search_leads` tool finds prospective customers by name, email, or company. It returns the lead source, current lead status—like 'Not Contacted' or 'Junk Lead'—and who owns the record.

You run `zoho_create_contact`. This tool lets you add name, email, phone, and crucially, link the contact directly to an existing account using its name. Contacts are for qualified individuals who are past the 'lead' stage.

The `zoho_list_records` tool lets you browse general overviews of any module, including Leads, Contacts, Accounts, and Deals. It returns records sorted by modification date so you know what's been worked on recently.

This server touches company-level records, specifically the Account Name. It handles sensitive information like annual revenue and industry type associated with a business entity.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript