Diurnal MCP server
The Mac to-do app your AI can use.
Connect Diurnal to Claude, ChatGPT, Cursor or any MCP client. Ask what's on today, add tasks mid-conversation, tick them off, and see it all on your Mac straight away.
Claude · ChatGPT · Claude Code · Cursor · VS Code
01 / Connect
Add Diurnal to your AI app.
Pick your app for its exact steps. Each one sends you to Diurnal to sign in and allow it, once.
https://api.diurnal.in/mcp- In Claude, on the web or the desktop app, open Customize › Connectors.
- Click + Add, then Add custom connector.
- Name it Diurnal, paste the address, then click Continue and Add.
- Sign in to Diurnal and click Allow. Claude can now use your tasks in any chat.
https://api.diurnal.in/mcp- In ChatGPT, open Settings › Security and login and turn on Developer mode.
- Open Plugins and press +.
- Name it Diurnal, paste the address under Connection, and create it.
- Sign in to Diurnal and click Allow.
- In a new chat, add Diurnal from the tools menu.
Developer mode depends on your ChatGPT plan and workspace settings.
claude mcp add --transport http diurnal https://api.diurnal.in/mcp- Run the command above.
- In a Claude Code session, type /mcp and choose diurnal.
- Sign in to Diurnal in the browser tab that opens and click Allow.
{
"mcpServers": {
"diurnal": {
"url": "https://api.diurnal.in/mcp"
}
}
}- Click Add to Cursor, or paste the snippet into your mcp.json.
- Cursor opens your browser. Sign in to Diurnal and click Allow.
https://api.diurnal.in/mcp- Open the Command Palette and run MCP: Add Server.
- Choose HTTP, paste the address and name it diurnal.
- VS Code opens your browser. Sign in to Diurnal and click Allow.
https://api.diurnal.in/mcp- Add a remote MCP server in your app with the address above. It uses Streamable HTTP.
- Sign-in is OAuth, so your app opens Diurnal in the browser. Sign in and click Allow.
- No API key or client ID needed: your app registers itself.
02 / What it can do
Your whole list, from the chat.
Everything goes through your Diurnal account and lands on your Mac.
Read your list
Today, any day, the week, everything without a date, or a search across titles, notes and tags.
Add, edit and finish tasks
Create tasks with a day or a time, move them, retag them, mark them done or delete them.
Read your calendar
It sees your Google Calendar events to plan around them, and never changes them.
You stay in charge
Its changes say “AI assistant” in a task’s history. Disconnect it any time in Settings › Account.
03 / Questions
About the MCP server.
The short answers.
What is an MCP server?
MCP, the Model Context Protocol, is how AI apps like Claude and ChatGPT use other apps. Diurnal's MCP server lets them read and change your to-do list.
Which AI apps work with Diurnal?
Claude, ChatGPT, Claude Code, Cursor, VS Code, and any app that can add a remote MCP server with sign-in.
Do I need the Mac app?
Yes. You create your Diurnal account in the Mac app, and the MCP server works on that same list.
Can it change my calendar?
No. It reads your Google Calendar events and leaves them as they are.
Does my AI app see my password?
No. You sign in on a Diurnal page, and the app gets its own key, which you can turn off any time in Settings › Account.