@olif/shipboard-mcp

Stdio MCP server for Shipboard. Lets any MCP-capable agent (Claude Code, Cursor, Cline, custom agents, etc.) read and write your Shipboard projects and tasks.

Install

pnpm add -g @olif/shipboard-mcp
# or run with: npx @olif/shipboard-mcp

Configure

Mint a personal token at /settings in the Shipboard web UI, then add the server to your MCP client config. Example for Claude Code:

{
  "mcpServers": {
    "shipboard": {
      "command": "npx",
      "args": ["-y", "@olif/shipboard-mcp"],
      "env": {
        "SHIPBOARD_TOKEN": "sbd_...",
        "SHIPBOARD_CONVEX_URL": "https://<deployment>.convex.site"
      }
    }
  }
}

SHIPBOARD_CONVEX_URL is your Convex site URL (ends in .convex.site), not the app URL.

Tools

• list_projects
• create_project
• list_tasks — filter by projectId and/or status
• create_task
• update_task — partial update
• delete_task

All calls are scoped to the token owner.