Use NeetoCal in Claude Code

Check requirements

• Claude Code installed on your computer.
• A NeetoCal account.

Connect NeetoCal to Claude Code

claude mcp add --transport http --scope user neetocal \
  https://connect.neetocal.com/mcp/messages

Start Claude Code, run /mcp, select neetocal, and sign in to your NeetoCal account.

Connect with an API key

An API key is not tied to a person. Every tool call reaches the whole workspace, and role checks do not run. Use a key for automation that must see every booking. Do not use one on a machine where the person should see only their own bookings.

It is the same key the REST API uses. Learn how to generate your API key. Create it in the workspace you want the assistant to reach. Every client sends it in this header:

Authorization: Bearer YOUR_API_KEY

Add the server to ~/.claude.json, then restart Claude Code:

{
  "mcpServers": {
    "neetocal": {
      "type": "http",
      "url": "https://connect.neetocal.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Let Claude Code use the CLI

You don't have to write these scripts yourself. Claude Code, Codex, or another coding agent can write the automation and use the open-source NeetoCal CLI to work with your account. Run neetocal setup claude (or setup codex, setup cursor) once, then ask:

Every weekday at 5 PM, use the NeetoCal CLI to get tomorrow's bookings and create a Markdown agenda. Write the script, test it, and set up the cron job.

Using the NeetoCal CLI, find every booking from acme.com in the last quarter and write a script that exports them to CSV every Monday.

You get the convenience of a chat, and the result is a script you can read, run, and commit.

Try these prompts

Look things up:

What NeetoCal bookings do I have this week?

Show me open slots for my Product Demo meeting on May 15 in America/New_York.

List the meetings I host.

Book outside your working hours. Only a host of the meeting or an admin can do this:

Book Oliver Smith into my demo meeting on May 15 at 8pm America/New_York, even though it's outside my hours.

Set up a meeting and your calendar:

Create a 30-minute meeting called Product Demo, hosted by me, over Zoom.

Add bookings of my Product Demo meeting to my Work Google calendar, and check only that calendar for conflicts.

Troubleshooting

Your AI assistant shows no NeetoCal tools

Restart the client first. Every client reads its MCP config at startup. On Claude or ChatGPT, confirm that you added the connector and finished the sign-in. In ChatGPT, the plugin is created only after you tick I understand and want to continue.

On clients that read a config file, check these:

1. The config key. Claude Code, Cursor, Devin, Antigravity, and Antigravity CLI use mcpServers. VS Code uses servers. Codex uses a [mcp_servers.<name>] section in TOML. A server under the wrong key is ignored silently.
2. The URL key. Antigravity and Antigravity CLI expect serverUrl. Claude Code, Codex, Cursor, Devin, and VS Code expect url.
3. The endpoint. It is https://connect.neetocal.com/mcp/messages, with no trailing slash.
4. The syntax. In JSON, a trailing comma or an unclosed brace makes the whole file unreadable.

The connection is refused or unauthorized

With an API key, the header must read Bearer YOUR_API_KEY, with the word Bearer and one space before the key. Check that the key is not revoked and belongs to the workspace you expect. A key from one workspace does not work in another. With OAuth, remove the connector and add it again to start the sign-in over.

More fixes are in the NeetoCal MCP troubleshooting guide.

Frequently asked questions

Can I use NeetoCal with Claude Code?

Yes. You can connect Claude Code directly to the NeetoCal MCP server using claude mcp add, or run neetocal setup claude to let Claude Code use the NeetoCal CLI. You can also use both.

Use NeetoCal in other AI assistants

Prefer the terminal? The NeetoCal CLI reaches the same data from your shell, your scripts and your coding agent.