# Zoho Notebook MCP MCP

> Zoho Notebook connects your private knowledge base to any AI agent. Use it to search, organize, and manage notes across all your projects—from listing entire notebooks to creating new notecards instantly via conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** personal-knowledge, digital-notes, organization, content-capture, syncing, task-management

## Description

Think of this as an assistant that knows where every single note you've ever taken lives. Instead of manually digging through folders or searching keywords in a web form, you just talk to your AI client about what you need. Need all the meeting notes for 'Project Chimera'? Just ask.

This MCP lets your agent read and write directly into your Zoho Notebook account. You can list every notebook you have, create new ones for fresh ideas, or find specific notecards across massive collections of data. It handles everything from creating text-only drafts to updating detailed entries with full metadata. Because all the credentials pass through a zero-trust proxy on Vinkius, your keys never sit on disk. This means you can trust your agent to handle highly private, sensitive project information while keeping your knowledge structured and actionable.

## Tools

### create_notebook
Creates a brand-new, empty notebook for organizing related notecards.

### create_notecard
Generates a new individual note card within an existing notebook.

### delete_notebook
Permanently removes an entire collection of notes and cards.

### delete_notecard
Removes a single, specific note card from its parent notebook.

### get_notebook
Retrieves the full details and metadata for one specific notebook ID.

### get_notecard
Pulls all content and metadata for a single notecard by its unique ID.

### list_notebooks
Returns a list of IDs for every notebook you own, which is needed to find cards inside them.

### list_notecards
Lists all the notecard titles and IDs contained within a specified notebook ID.

### search_notecards
Searches across your entire knowledge base by keyword to find relevant notes quickly.

### update_notecard
Changes the content or metadata of an existing notecard with new information.

## Prompt Examples

**Prompt:** 
```
List all my notebooks in Zoho Notebook.
```

**Response:** 
```
I found 3 notebooks: 1. 'Personal Ideas' (ID: nb-101), 2. 'Project Roadmap' (ID: nb-102), and 3. 'Meeting Notes' (ID: nb-103). Which one would you like to browse?
```

**Prompt:** 
```
Create a new text note in 'nb-101' called 'Gift Ideas' with content 'Buy a watch for John'.
```

**Response:** 
```
Success! I've created the notecard 'Gift Ideas' (ID: card-999) inside your 'Personal Ideas' notebook. Is there anything else you'd like to capture?
```

**Prompt:** 
```
Search for notes about 'React navigation'.
```

**Response:** 
```
Searching notebooks... I found 2 cards: 1. 'Frontend Best Practices' (in nb-102) and 2. 'Library Wishlist' (in nb-101). Would you like the full content for either of these?
```

## Capabilities

### List entire notebooks
The agent returns a list of all available notebook containers, giving you the IDs needed for deeper work.

### Find specific notecards
You can search across every card in your system by keyword to instantly locate relevant notes or ideas.

### Create new content drafts
Instantly generate and save new text or checklist notecards within a specified notebook using simple prompts.

### Modify existing entries
The agent updates the body content of old notes, allowing you to add fresh information without starting over.

### Clean up obsolete data
You can permanently delete entire notebooks or single notecards that are no longer relevant to your work.

## Use Cases

### The researcher needs to consolidate findings.
A student has hundreds of source notes scattered across ten notebooks. Instead of opening each one, they ask the agent to `search_notecards` for 'quantum physics' and get a consolidated list of all relevant cards from different sources.

### The PM needs to audit project scope.
A product lead wants to verify what notes exist in the 'Q3 Roadmap' notebook. They ask the agent to `list_notecards` for that specific ID, quickly building a content map before starting development.

### The writer needs to capture an idea on the go.
A content creator has a sudden realization about their next article. They tell the agent to `create_notecard` in their 'Draft Ideas' notebook, capturing the title and core concept immediately.

### The team needs to archive old work.
A project lead knows a whole set of notes is obsolete. They use the agent to `delete_notebook` entirely, keeping their primary knowledge base clean and focused on active projects.

## Benefits

- You never lose track of project ideas again. Instead of manually listing containers, the agent uses `list_notebooks` to show you every notebook ID at a glance.
- Finding specific information is instant. The `search_notecards` tool scans your entire collection by keyword, pulling out exactly what you need without manual filtering.
- Creating drafts takes zero effort. You can use `create_notecard` with just a title and body content to instantly capture an idea the moment it hits you.
- Keep your knowledge current. If details change, run `update_notecard`. This lets you add fresh data points to old notes without having to recreate them entirely.
- It keeps things clean. When a project is dead, the agent handles cleanup using `delete_notebook` or `delete_notecard`, keeping your knowledge base focused.

## How It Works

The bottom line is: your AI client treats your notes like an internal database, letting you query and modify knowledge using plain language prompts.

1. First, connect your Zoho Notebook account and provide the required Access Token to Vinkius.
2. Next, tell your AI client exactly what you need—for example, 'List all my notebooks for Q3 planning.'
3. The agent executes the action, retrieves the data (like a list of IDs), and presents it back to you in natural conversation.

## Frequently Asked Questions

**How do I list all my available notes using the Zoho Notebook MCP?**
You use the `list_notebooks` tool. This tells your agent every notebook ID you have, which is the first step before listing any cards inside them.

**Can I find a note if I only remember a few words? Zoho Notebook MCP?**
Yes, use `search_notecards`. This tool scans your entire collection by keyword. You don't need the full title or ID; just give it the words.

**What if I want to change an old card? Do I use Zoho Notebook MCP?**
Use `update_notecard`. This tool lets you modify existing content, ensuring that your changes are saved back into the correct original note.

**Is it safe for my private notes when using Zoho Notebook MCP?**
Yes. Vinkius handles all credential exchange through a zero-trust proxy; your access tokens never sit on disk, keeping your data secure during every call.

**How do I connect my Zoho Notebook account to the MCP?**
You provide a valid Zoho Access Token during setup. The Vinkius platform handles this token through a zero-trust proxy, meaning your credentials pass in transit but never sit on disk.

**When should I use the `create_notebook` tool?**
Use it when you need to isolate distinct topics or projects. This lets you group related notecards into a dedicated collection, keeping your entire knowledge base clean and segmented.

**What happens if I have thousands of cards in one notebook using `list_notecards`?**
The agent handles large volumes automatically. It retrieves and lists notecards in manageable chunks, giving you full access to the content without running into immediate limits.

**What is the process for removing an entire old project using `delete_notebook`?**
The MCP confirms deletion before it executes. You tell your agent which notebook needs to go, and it manages the removal of that whole collection, including all its contents.

**Can I search for specific keywords across all my notebooks?**
Yes. The `search_notecards` tool allows your AI agent to perform a global search across your entire Zoho Notebook account, returning all cards that match your query string instantly.

**How do I add a new checklist or note to a specific notebook?**
You can use the `create_notecard` tool. Provide the parent `notebook_id`, a title, and the content. You can also specify the type as 'text' or 'checklist' to match your organizational needs.

**Is it possible to see the full content of a card via chat?**
Absolutely. Use the `get_notecard_details` tool and provide the notebook and card IDs. Your agent will retrieve the full body content and metadata for that specific note.