> ## Documentation Index
> Fetch the complete documentation index at: https://docs.znift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server Setup

> Connect Znift to Claude Desktop, Claude Code, Cursor, OpenClaw, and other MCP-compatible AI tools.

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard that lets AI tools connect to external services. Znift hosts an MCP server that gives your AI agent full access to your tasks.

## Configuration

Add Znift to your AI tool's MCP configuration. Replace `your-znift-api-key` with your actual API key from [Profile > API Keys](https://znift.com/dashboard/api-keys).

<Tabs>
  <Tab title="Claude Desktop">
    Edit your Claude Desktop config file:

    * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

    ```json theme={null}
    {
      "mcpServers": {
        "znift": {
          "url": "https://znift.com/mcp",
          "headers": {
            "x-api-key": "your-znift-api-key"
          }
        }
      }
    }
    ```

    Restart Claude Desktop after saving.
  </Tab>

  <Tab title="Claude Code">
    Add to your project's `.claude/settings.json` or global settings:

    ```json theme={null}
    {
      "mcpServers": {
        "znift": {
          "url": "https://znift.com/mcp",
          "headers": {
            "x-api-key": "your-znift-api-key"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Go to **Settings > MCP Servers > Add Server** and configure:

    ```json theme={null}
    {
      "mcpServers": {
        "znift": {
          "url": "https://znift.com/mcp",
          "headers": {
            "x-api-key": "your-znift-api-key"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="OpenClaw">
    Add to your OpenClaw MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "znift": {
          "url": "https://znift.com/mcp",
          "headers": {
            "x-api-key": "your-znift-api-key"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Available Tools

Once connected, your AI agent has access to the following tools:

| Tool            | Description                                                 |
| --------------- | ----------------------------------------------------------- |
| `list_tasks`    | List all tasks for a specific date                          |
| `create_task`   | Create a new task with text, date, priority, and more       |
| `get_task`      | Get a single task by ID                                     |
| `update_task`   | Update fields on an existing task                           |
| `delete_task`   | Permanently delete an archived task                         |
| `search_tasks`  | Full-text search across all tasks                           |
| `get_analytics` | Completion stats and trends for a date range                |
| `get_dashboard` | Daily overview with overdue, pending, completed, and streak |
| `list_archived` | List all archived tasks                                     |
| `archive_task`  | Move a task to the archive                                  |
| `restore_task`  | Restore an archived task to its original date               |
| `toggle_task`   | Toggle a task between completed and pending                 |
| `move_task`     | Move a task to a different date                             |

## Example Conversations

After setup, try these prompts with your AI agent:

* "What's on my plate today?"
* "Add a high-priority task for tomorrow: finalize the proposal"
* "Log that I merged 3 PRs today"
* "Record that I had a 1:1 with Sarah yesterday"
* "Mark the code review task as done"
* "Move the team sync to next Monday"
* "Search for anything about the API migration"
* "How productive was I this week?"

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools not appearing">
    Make sure you've restarted your AI tool after adding the MCP configuration. Check that your API key is correct and starts with `znift_`.
  </Accordion>

  <Accordion title="Authentication errors">
    Verify your API key at [Profile > API Keys](https://znift.com/dashboard/api-keys). Generate a new key if needed.
  </Accordion>

  <Accordion title="Rate limiting">
    The API allows 300 requests per minute per API key. If you hit the limit, wait a moment and try again.
  </Accordion>
</AccordionGroup>