mcp ai tutorial developer

What Is an MCP Server and Why Your Notes Need One

Learn what the Model Context Protocol (MCP) is and how an MCP server turns your notes into a tool that AI agents can read, search, and organize. Setup guide included.

SlashNote Team

Your notes sit in one app. Your AI assistant lives in another. Every time you want context from your notes, you copy-paste, re-explain, or start from scratch.

MCP changes that.

What Is the Model Context Protocol?

The Model Context Protocol (MCP) is an open standard created by Anthropic that lets AI assistants connect directly to external tools and data sources. Think of it as a USB port for AI — a universal way for any AI model to read from, write to, and interact with software on your computer.

Before MCP, every AI integration was custom-built. Each app needed its own plugin for each AI assistant. MCP replaces that fragmentation with a single protocol that any AI client can speak.

Here is how it works in practice:

  1. An MCP server exposes a set of tools (functions the AI can call)
  2. An MCP client (like Claude Desktop, Cursor, or VS Code) connects to the server
  3. The AI assistant can now use those tools as part of its conversation with you

When you ask Claude “What did I write about the API redesign last week?”, Claude calls the MCP server’s search tool, finds the relevant note, and gives you the answer — all within the same conversation.

Why MCP Matters for Note-Taking

Notes are only valuable when you can find and use them. Most notes end up forgotten because:

  • Search is manual — you have to remember which app, which folder, which keywords
  • AI has no context — ChatGPT and Claude don’t know what you wrote yesterday
  • Copy-paste breaks flow — switching between apps to give AI your context takes 30+ seconds

An MCP server for your notes solves all three problems. Your AI assistant gets direct access to your notes — no copy-paste, no manual search, no context switching.

What becomes possible

  • Ask Claude to summarize all notes from this week
  • Tell Cursor to create a note documenting your current code changes
  • Have VS Code search your notes for a decision you recorded last month
  • Ask Claude Code to read your project notes before starting work
  • Let AI agents organize, tag, and structure your notes automatically

How SlashNote’s MCP Server Works

SlashNote includes a built-in MCP server with 19 tools and 6 prompt templates. It runs locally on your Mac — no cloud, no API keys, no external services.

19 Tools Available to AI Agents

Note Management:

  • create_note — Create a new note with title, content, and color
  • read_note — Read the full content of a specific note
  • update_note — Modify an existing note’s title or content
  • delete_note — Remove a note
  • list_notes — Get all notes with metadata

Search:

  • search_notes — Full-text search across all notes

Checkboxes:

  • toggle_checkbox — Toggle checkbox between 3 states: unchecked, inProgress, done
  • reorder_checkboxes — Move done items to the end of the list

Window Management:

  • show_note — Bring a note window to the front
  • hide_note — Close a note window
  • move_note — Reposition a note on screen
  • resize_note — Change the size of a note window

Utility:

  • duplicate_note — Copy a note with an offset
  • get_stats — Get note counts and limits
  • get_open_notes — List open note windows with their positions

Automation:

  • start_note_loop — Schedule automated task execution from a checklist note
  • cancel_note_loop — Cancel a scheduled automation loop
  • list_note_loops — List all active scheduled loops
  • complete_note_loop — Mark a loop as completed with summary

6 Prompt Templates

Prompt templates are pre-built workflows that AI agents can use:

  1. meeting-notes — Create meeting notes with attendees and action items
  2. todo-list — Generate project-based task lists
  3. checklist — Step-by-step procedure checklists
  4. summarize-notes — Consolidate all notes into a summary
  5. organize-tasks — Sort and group checkboxes by status
  6. weekly-review — Weekly accomplishments and next week goals

Setting Up SlashNote MCP in 60 Seconds

The setup is a single JSON block added to your MCP client configuration.

For Claude Desktop

Open Claude Desktop settings and add this to your MCP configuration:

{
  "mcpServers": {
    "slashnote": {
      "command": "/Applications/SlashNote.app/Contents/MacOS/slashnote-mcp"
    }
  }
}

Restart Claude Desktop. That is it. Claude can now read and create your notes.

For Cursor

Open Cursor settings (Cmd+,), navigate to MCP servers, and add:

{
  "mcpServers": {
    "slashnote": {
      "command": "/Applications/SlashNote.app/Contents/MacOS/slashnote-mcp"
    }
  }
}

For Claude Code

Run this in your terminal:

claude mcp add slashnote /Applications/SlashNote.app/Contents/MacOS/slashnote-mcp

For VS Code

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "slashnote": {
      "command": "/Applications/SlashNote.app/Contents/MacOS/slashnote-mcp"
    }
  }
}

5 Things You Can Do with MCP Notes

1. Give AI context about your projects

“Read my notes about the checkout redesign and suggest what to work on next.”

Instead of re-explaining your project context every conversation, Claude reads your notes and already knows the background.

2. Capture decisions during AI conversations

“Create a note titled ‘Auth Decision’ documenting that we chose JWT over sessions.”

Decisions made during AI-assisted coding sessions get captured automatically, right where you need them.

3. Search across all your notes with natural language

“Find all notes where I mentioned the payment API.”

Full-text search powered by your AI assistant — no need to remember exact keywords or folder structures.

4. Automate weekly reviews

“Summarize everything I wrote this week and create a weekly review note.”

AI reads all your notes from the past 7 days, identifies themes, and creates a structured summary.

5. Build a development log

“After each commit, create a note with today’s changes and what I plan to do tomorrow.”

Turn your notes into a living development diary that AI helps maintain.

MCP vs Traditional Note Integrations

AspectTraditional IntegrationsMCP Server
SetupAPI keys, OAuth, webhooksOne JSON line
PrivacyData goes through cloud APIs100% local
FlexibilityFixed features per integrationAI decides how to use tools
MaintenanceBreaks when APIs changeStable local protocol
Works withOne specific serviceAny MCP client
LatencyNetwork round-tripsInstant (local)

The key difference: traditional integrations give you pre-built features. MCP gives AI agents raw tools and lets them figure out the best way to help you.

Frequently Asked Questions

Does MCP send my notes to the cloud?

No. SlashNote’s MCP server runs entirely on your Mac. Your notes never leave your machine. The AI client (Claude Desktop, Cursor, etc.) communicates with the server locally.

Do I need to pay for MCP access?

MCP server access requires SlashNote Pro. The free tier includes unlimited notes. Pro adds MCP server, voice input, and 50 AI requests per day.

Which AI clients support MCP?

As of 2026, MCP is supported by Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot Chat), and Windsurf. The ecosystem is growing rapidly.

Can MCP modify my notes without asking?

MCP tools are called by your AI assistant only when you ask. Claude will not randomly edit your notes. You always see what tools the AI wants to use and can approve or deny the action.

What happens if I close SlashNote?

The MCP server requires SlashNote to be running. If you quit the app, AI clients will lose access to your notes until you reopen it. Since SlashNote lives in your menu bar, it is designed to always be running.

Can I use MCP with local AI models?

Yes. If you use an MCP client that supports local models (like Ollama through compatible clients), you can use the MCP server with fully local AI — meaning both your notes and your AI processing stay on your Mac.


MCP is the bridge between your notes and your AI assistant. Instead of copying context back and forth, your AI can work directly with your notes — search, create, organize — all while your data stays on your Mac.

Download SlashNote free on the Mac App Store and set up MCP in under 60 seconds.

Download for Free

Available on the Mac App Store for macOS 15+

Download on the App Store