# Plannie

Plannie is an MCP server for Claude Code that lets an agent work with a family’s Plannie calendar, tasks and lists. It also connects to files and meal plans.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: plannie-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/plannie-io/plannie-docs
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/plannie

## What it does

Plannie gives an AI agent access to a family’s calendar, tasks, lists, files and meal plan in Plannie. Requests can cover everyday updates, such as adding a calendar event or changing a list.

Claude Code can connect over HTTP using the server address. Another setup runs `plannie-mcp` through `npx` and requires `PLANNIE_API_KEY`, `PLANNIE_API_URL` and `PLANNIE_AGENT_NAME`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.plannie.io/mcp`
- Environment variables: `PLANNIE_API_KEY`, `PLANNIE_API_URL`, `PLANNIE_AGENT_NAME` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http plannie https://api.plannie.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env PLANNIE_API_KEY=<PLANNIE_API_KEY> --env PLANNIE_API_URL=<PLANNIE_API_URL> --env PLANNIE_AGENT_NAME=<PLANNIE_AGENT_NAME> --transport stdio plannie -- npx -y plannie-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add plannie --url https://api.plannie.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add plannie --env PLANNIE_API_KEY=<PLANNIE_API_KEY> --env PLANNIE_API_URL=<PLANNIE_API_URL> --env PLANNIE_AGENT_NAME=<PLANNIE_AGENT_NAME> -- npx -y plannie-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "plannie": {
            "url": "https://api.plannie.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "plannie": {
            "command": "npx",
            "args": [
                "-y",
                "plannie-mcp"
            ],
            "env": {
                "PLANNIE_API_KEY": "<PLANNIE_API_KEY>",
                "PLANNIE_API_URL": "<PLANNIE_API_URL>",
                "PLANNIE_AGENT_NAME": "<PLANNIE_AGENT_NAME>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "plannie": {
            "type": "http",
            "url": "https://api.plannie.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "plannie": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "plannie-mcp"
            ],
            "env": {
                "PLANNIE_API_KEY": "<PLANNIE_API_KEY>",
                "PLANNIE_API_URL": "<PLANNIE_API_URL>",
                "PLANNIE_AGENT_NAME": "<PLANNIE_AGENT_NAME>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http plannie https://api.plannie.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e PLANNIE_API_KEY=<PLANNIE_API_KEY> -e PLANNIE_API_URL=<PLANNIE_API_URL> -e PLANNIE_AGENT_NAME=<PLANNIE_AGENT_NAME> plannie npx -y plannie-mcp
```
Replace <…> with your own values

## When to use it
- add an event to a family Plannie calendar
- organize family tasks and lists
- access family files through an AI agent
- update a family meal plan

## Example prompts
- Add a family event to the Plannie calendar for Friday.
- Show the family’s tasks and lists in Plannie.
- Update the meal plan and add the needed items to the list.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
