Skip to content
Day Planner

Connect an agent

Day Planner includes an MCP server. With it, an AI agent can create tasks, check today’s schedule and re-plan your week, using an API key that acts as you.

Create an API key

Section titled “Create an API key”
  1. In Day Planner, open Settings.
  2. Under API keys, enter a name such as “Claude Code”, pick an expiry and select Create key.
  3. Copy the key. It starts with dp_ and is shown only once.

Get the MCP server

Section titled “Get the MCP server”

The server is in the mcp/ folder of the repository. It needs Node.js 20 or later.

Terminal window
git clone https://github.com/Deejpotter/day-planner.git
cd day-planner/mcp && npm install

Add it to your client

Section titled “Add it to your client”

Claude Code

Section titled “Claude Code”

This command registers the server with your instance’s URL and key.

Terminal window
claude mcp add day-planner \
  -e DAY_PLANNER_URL=https://tasks.example.com \
  -e DAY_PLANNER_API_KEY=dp_change-me \
  -- node /path/to/day-planner/mcp/server.mjs

Replace the URL, key and path with your own. The agent can now use the MCP tools.

Claude Desktop and other clients

Section titled “Claude Desktop and other clients”

Add this to the client’s MCP configuration file. Settings → API keys → Connect an agent in Day Planner shows the same snippet with your URL filled in.

{
  "mcpServers": {
    "day-planner": {
      "command": "node",
      "args": ["/path/to/day-planner/mcp/server.mjs"],
      "env": {
        "DAY_PLANNER_URL": "https://tasks.example.com",
        "DAY_PLANNER_API_KEY": "dp_change-me"
      }
    }
  }
}

Set DAY_PLANNER_TZ too if you’re not in Australia/Sydney; it decides what “today” means for the agent.

See also

Section titled “See also”