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

# Explore with AI

> Connect Oakminder's documentation to your favorite AI tool and ask it anything about the app.

<video src="https://mintcdn.com/oakminder/HvG6VisZeV0jLAHu/videos/OakminderMCP.mp4?fit=max&auto=format&n=HvG6VisZeV0jLAHu&q=85&s=7de3dc44f23afa92a3b7bce4aa901c9e" autoPlay muted loop playsInline controls data-path="videos/OakminderMCP.mp4" />

You could read through every page of these docs. Or you could connect them to your AI tool and just ask questions.

Oakminder's documentation is available as an MCP (Model Context Protocol) server. That means any AI tool that supports MCP can search these docs directly and give you answers based on what's actually written here. Not generic web results. The real documentation.

Probably the quickest way to get up to speed on how Oakminder works and why it was built this way.

<Check>
  Your AI tool gets a search tool that queries every page of Oakminder's documentation. Features, design decisions, the origin story, all of it.
</Check>

## The URL

<Note>
  **MCP Server URL**: `https://docs.oakminder.com/mcp`

  This is the only URL you need. Every setup below uses this same address.
</Note>

## Connect your AI tool

Pick your tool and follow the steps. The whole thing takes about thirty seconds.

<Tabs>
  <Tab title="Claude">
    To use the Oakminder MCP server with Claude:

    <Steps>
      <Step title="Add the Oakminder MCP server to Claude">
        1. Navigate to the [Connectors](https://claude.ai/settings/connectors) page in your Claude settings.
        2. Select **Add custom connector**.
        3. Add the Oakminder MCP server:
           * Name: `Oakminder`
           * URL: `https://docs.oakminder.com/mcp`
        4. Select **Add**.
      </Step>

      <Step title="Use it in a conversation">
        1. When using Claude, select the attachments button (the plus icon).
        2. Select the Oakminder MCP server.
        3. Ask Claude a question about Oakminder.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    To use the Oakminder MCP server with Claude Code, run this command:

    ```bash theme={"dark"}
    claude mcp add --transport http Oakminder https://docs.oakminder.com/mcp
    ```

    Verify the connection:

    ```bash theme={"dark"}
    claude mcp list
    ```

    <Tip>
      Now when you ask Claude Code about Oakminder, it will search these docs for context before answering.
    </Tip>
  </Tab>

  <Tab title="Cursor">
    To connect the Oakminder MCP server to Cursor:

    <Steps>
      <Step title="Open MCP settings">
        1. Use **Command** + **Shift** + **P** (**Ctrl** + **Shift** + **P** on Windows) to open the command palette.
        2. Search for "Open MCP settings".
        3. Select **Add custom MCP**. This opens the `mcp.json` file.
      </Step>

      <Step title="Configure the Oakminder MCP server">
        In `mcp.json`, add:

        ```json theme={"dark"}
        {
          "mcpServers": {
            "Oakminder": {
              "url": "https://docs.oakminder.com/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    To connect the Oakminder MCP server to VS Code, create a `.vscode/mcp.json` file and add:

    ```json theme={"dark"}
    {
      "servers": {
        "Oakminder": {
          "type": "http",
          "url": "https://docs.oakminder.com/mcp"
        }
      }
    }
    ```

    See the [VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more details.
  </Tab>
</Tabs>

## What to ask

Once you're connected, try questions like these:

* "What makes Oakminder different from other reminder apps?"
* "How does the custom snooze feature work?"
* "Explain the recurring reminders system and how per-occurrence completion works"
* "How does cross-device notification dismissal work?"
* "Tell me about the voice agent and how it processes commands"
* "Who built this app and what's the origin story?"

## Works with other tools

MCP is an open protocol. The server works with any tool that supports it, including Claude, Claude Code, Cursor, VS Code, ChatGPT, Goose, and others. If your tool supports MCP, point it at the URL above and you're good to go.

You can also use the context menu at the top of any page on this site to quickly copy the MCP URL or install the server directly into Cursor or VS Code.

## Keep exploring

<CardGroup cols={2}>
  <Card title="Why this exists" icon={<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M12 1.25C6.06294 1.25 1.25 6.06294 1.25 12C1.25 17.9371 6.06294 22.75 12 22.75C17.9371 22.75 22.75 17.9371 22.75 12C22.75 6.06294 17.9371 1.25 12 1.25ZM13 8C13 7.44772 12.5523 7 12 7C11.4477 7 11 7.44772 11 8V12C11 12.2652 11.1054 12.5196 11.2929 12.7071L13.2929 14.7071C13.6834 15.0976 14.3166 15.0976 14.7071 14.7071C15.0976 14.3166 15.0976 13.6834 14.7071 13.2929L13 11.5858V8Z" fill="currentColor" fillRule="evenodd"/></svg>} href="/support/why-oakminder">
    The origin story, the frustrations, and the philosophy behind every feature.
  </Card>
</CardGroup>
