mcp-server

# PandaNpc MCP Server

PandaNpc MCP Server — expose PandaNote, workspaces, AI models, scheduled tasks, and Agent connection management to Codex, Claude Code, Cursor, Windsurf, and other MCP clients.

Homepage: https://pandanpc.com · npm: [`@pandanpc/mcp-server`](https://www.npmjs.com/package/@pandanpc/mcp-server)

## Installation

```bash
npm install -g @pandanpc/mcp-server
```

The `postinstall` script downloads the matching prebuilt binary for your platform (Linux x64, macOS x64/arm64, Windows x64).

## Claude Code

```bash
claude mcp add pandanpc -- pandanpc-mcp
```

Or in config JSON:

```json
{
  "mcpServers": {
    "pandanpc": { "command": "pandanpc-mcp" }
  }
}
```

## Codex

`~/.codex/config.toml`:

```toml
[mcp_servers.pandanpc]
command = "pandanpc-mcp"
```

## Cursor / Windsurf

Add an MCP server with command `pandanpc-mcp` (stdio). HTTP/SSE mode: `pandanpc-mcp --http --port 3100`.

## Available tools

- `note_login` — log in to your PandaNpc account
- Workspaces: `list_workspaces` / `create_workspace` / `update_workspace` / `delete_workspace`
- Notes: `list_notes` / `create_note` / `read_note` / `update_note` / `delete_note` / `search_notes` (full-text + semantic) / `generate_note_title`
- AI models & providers: `list_models` / `create_model` / `list_providers` / `create_provider` / …
- Agent connections: `list_agent_connections` / `create_agent_connection` — manage Claude Code / Codex / PandaCode remote connections
- Scheduled tasks: `list_scheduled_tasks` / `create_scheduled_task` / `toggle_scheduled_task` / …
- `sync_rules` — sync `.claude/rules/` and `.claude/skills/` Markdown to PandaNote

Call `note_login` first to authenticate.

## About

This repository hosts documentation and issue tracking for the PandaNpc MCP server. The server ships as prebuilt binaries via the npm installer above (installer is MIT-licensed; the binary is proprietary freeware). Learn more at [pandanpc.com](https://pandanpc.com).