Model Context Protocol

The PandaNpc MCP server

Give Claude Code, Claude Desktop, Codex and Cursor 38 tools over your notes, AI models, scheduled tasks and agent connections. One command to install, no API key.

claude mcp add pandanpc -- npx -y @pandanpc/mcp-server

Works on Linux, macOS (Intel & Apple Silicon) and Windows. The binary is fetched on first run.

How it fits together

Your MCP client speaks the protocol over stdio. The server translates those calls into your PandaNpc account — the same notes and settings you see on the web.

MCP clientsstdio · JSON-RPCYour PandaNpc accountClaude CodeClaude DesktopCodexCursor…any MCP clientPandaNpcMCP server38 toolsNotes & workspacesAI models & providersScheduled tasksRules & work logAgent connections

38 MCP tools

Grouped by what they touch. Every name below is what the model actually sees in tools/list.

Notes & workspaces

14 tools

Read, write, search and reorganise PandaNote documents. Markdown in, blocks out — headings, tables, todo lists with nesting, code blocks and Mermaid diagrams all round-trip.

  • create_note
  • read_note
  • update_note
  • delete_note
  • search_notes
  • list_notes
  • generate_note_title
  • move_note_to_parent
  • move_note_to_workspace
  • create_workspace
  • update_workspace
  • delete_workspace
  • list_workspaces
  • note_login

AI models & providers

9 tools

Register providers, add or retire models, inspect what is configured — so the agent can manage its own model catalogue instead of you clicking through a dashboard.

  • list_models
  • create_model
  • update_model
  • delete_model
  • list_model_types
  • list_providers
  • create_provider
  • update_provider
  • delete_provider

Scheduled tasks

7 tools

Cron-style jobs that run an agent on a schedule. Create them, edit prompts, toggle them on and off, and read past runs — all from inside a conversation.

  • create_scheduled_task
  • update_scheduled_task
  • delete_scheduled_task
  • toggle_scheduled_task
  • list_scheduled_tasks
  • list_scheduled_task_runs
  • list_scheduled_bridges

Rules & work log

6 tools

Sync instruction files across machines and record what was done. Useful when several agents share one repository and need the same guidance.

  • sync_rules
  • save_done
  • asc_guide
  • asc_list_arbitrations
  • asc_get_arbitration_diff
  • asc_resolve_arbitration

Agent connections

2 tools

List and create the connections that let an agent reach your machines.

  • list_agent_connections
  • create_agent_connection

Supported MCP clients

ClientSetup
Claude Codeclaude mcp add pandanpc -- npx -y @pandanpc/mcp-server
Claude DesktopAdd to claude_desktop_config.json under mcpServers
Codex[mcp_servers.pandanpc] command = "pandanpc-mcp" in config.toml
Cursor / other MCP clientsAny client speaking MCP over stdio

Frequently asked questions

What is the Model Context Protocol?

MCP is an open protocol that lets an AI assistant talk to external systems through a uniform interface. Instead of every tool inventing its own plugin format, a client such as Claude Code speaks MCP to any number of servers. Each server advertises a list of tools; the model decides which to call and the client executes them.

How do I add this MCP server to Claude Code?

Run claude mcp add pandanpc -- npx -y @pandanpc/mcp-server. The npm package downloads a platform binary on first run (Linux, macOS Intel and Apple Silicon, Windows). Then run claude mcp list to confirm it is connected.

Does it need an API key?

No API key. The first call asks you to sign in with an email verification code, and the credentials are cached locally for 90 days. Nothing is stored in your shell history or config files.

Where does my data live?

Notes are stored in your PandaNpc account, the same ones you see on the web and in the desktop and iOS apps. The MCP server is a client of that account, not a separate copy — an agent writing a note updates the document you already have open.

Can several agents use it at once?

Yes. Note edits go through incremental sync rather than whole-document replacement, so two agents editing different parts of the same note do not clobber each other.

How do I remove it?

claude mcp remove pandanpc. Nothing is left behind except the cached credentials file, which you can delete at ~/.pandanpc-mcp/credentials.json.

Add it in one command

claude mcp add pandanpc -- npx -y @pandanpc/mcp-server