npm package: @latercue/mcp-server
Description: LaterCue MCP server - Connect your coding agent to your task queue
Author: LaterCue
Latest version: 1.0.7

# @latercue/mcp-server

Connect your coding agent to your LaterCue task queue. Sync tasks between the LaterCue mobile app and your IDE.

## Installation

```bash
npx -y @latercue/mcp-server login
```

This opens a browser for authentication. Sign in with the same account you use in the LaterCue app (Google, Apple, or email).

> **Note**: MCP integration requires a Pro subscription. Download the [LaterCue app](https://apps.apple.com/app/latercue/id6758955443) and subscribe to Pro to get started.

## Setup

Add LaterCue to your IDE's MCP configuration, then restart your IDE.

### Claude Code

Run:

```bash
claude mcp add latercue --scope user -- npx -y @latercue/mcp-server
```

This adds LaterCue globally so it's available in every project. Restart Claude Code, then run `/mcp` to verify it appears.

> **Tip**: If you use `--scope project` (or a `.mcp.json` file) instead, Claude Code will prompt you to approve the server on first use. Run `claude mcp reset-project-choices` if you need to re-trigger the approval.

Alternatively, create `.mcp.json` in your project root:

```json
{
  "mcpServers": {
    "latercue": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@latercue/mcp-server"]
    }
  }
}
```

### Cursor

Create `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` for global access):

```json
{
  "mcpServers": {
    "latercue": {
      "command": "npx",
      "args": ["-y", "@latercue/mcp-server"]
    }
  }
}
```

### VS Code

Add to your User Settings JSON (`Cmd+Shift+P` → "Preferences: Open User Settings (JSON)"):

```json
{
  "mcp": {
    "servers": {
      "latercue": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@latercue/mcp-server"]
      }
    }
  }
}
```

### Windsurf

Create `.windsurf/mcp.json` in your project root (or `~/.windsurf/mcp.json` for global access):

```json
{
  "mcpServers": {
    "latercue": {
      "command": "npx",
      "args": ["-y", "@latercue/mcp-server"]
    }
  }
}
```

### Codex

Add to `~/.codex/config.toml` (or `.codex/config.toml` in your project root):

```toml
[mcp_servers.latercue]
command = "npx"
args = ["-y", "@latercue/mcp-server"]
```

Or run:

```bash
codex mcp add latercue -- npx -y @latercue/mcp-server
```

### Antigravity

Open the Antigravity sidebar, click **MCP Servers** > **Manage MCP Servers** > **View raw config**, then add:

```json
{
  "mcpServers": {
    "latercue": {
      "command": "npx",
      "args": ["-y", "@latercue/mcp-server"]
    }
  }
}
```

## Usage

Ask your coding agent:

- **"What LaterCue tasks do I have?"** - Lists pending tasks
- **"Mark the React migration task as done"** - Completes a task
- **"Save this link to my LaterCue queue"** - Adds a new task
- **"Show my business profiles"** - Lists your profiles
- **"Delete the old SEO task"** - Removes a task
- **"Change the priority of that task to high"** - Updates a task
- **"Show the action plan for that task"** - Views step-by-step plan
- **"Mark step 1 of that plan as done"** - Tracks plan progress
- **"Search my tasks for marketing ideas"** - Semantic search across all tasks

## Available Tools

| Tool | Description |
|------|-------------|
| `latercue_get_tasks` | Get pending or completed tasks, optionally filtered by profile |
| `latercue_approve_task` | Mark a task as complete |
| `latercue_add_task` | Add a new task/URL to your queue |
| `latercue_get_profiles` | List your business profiles |
| `latercue_update_task` | Update a task's description, priority, or time estimate |
| `latercue_delete_task` | Permanently delete a task |
| `latercue_get_plan` | Get the AI-generated action plan for a task |
| `latercue_toggle_plan_step` | Mark a step in a task's action plan as complete or incomplete |
| `latercue_search_tasks` | Semantic search across tasks using natural language |

## CLI Commands

| Command | Description |
|---------|-------------|
| `npx -y @latercue/mcp-server login` | Authenticate with your LaterCue account |
| `npx -y @latercue/mcp-server logout` | Remove saved credentials |
| `npx -y @latercue/mcp-server status` | Check login status and subscription tier |

## Troubleshooting

### "Not logged in"
Run `npx -y @latercue/mcp-server login` to authenticate.

### "MCP_PRO_REQUIRED"
MCP integration requires a Pro subscription. Download the [LaterCue app](https://apps.apple.com/app/latercue/id6758955443) and subscribe to Pro from the app.

### Tasks not syncing
Ensure you're signed in with the same account (Google, Apple, or email) in both the app and CLI.

### Server not showing in Claude Code `/mcp`
- **Restart Claude Code** after adding the config — MCP servers are loaded at startup
- If using project-scoped `.mcp.json`, you must approve the server on first launch. Run `claude mcp reset-project-choices` to re-trigger the prompt
- Use `--scope user` to skip the approval step: `claude mcp add latercue --scope user -- npx -y @latercue/mcp-server`

### Server not connecting
- Verify the server starts: `npx -y @latercue/mcp-server status`
- Restart your IDE after adding the MCP configuration
- Check that `npx` is available in your PATH

## License

MIT