Pocket Archive

Pocket Archive MCP Server

Connect Claude, ChatGPT, Cursor, VS Code, Codex or any MCP app to your Pocket Archive, the AI document organizer for receipts, bills, contracts, warranties and tax documents. Your agent can search your documents, read their text, upload new files, track deadlines and organize records into Smart Collections, with read-only or read-and-write access you approve.

Server URL: https://api.pocketarchive.io/mcp · Streamable HTTP · OAuth sign-in · Setup guide on pocketarchive.io

This is a hosted (remote) MCP server; there is nothing to install or run locally. This repository contains its connection details, a reusable Skill and optional client adapters.

Before you start

You need a Pocket Archive account. Create one for free. MCP access is included on every plan, including Free; uploads still count toward your plan's text recognition and storage limits.

Set up your app

Every app uses the same server URL: https://api.pocketarchive.io/mcp. The first time your app connects, it opens Pocket Archive in your browser. Check the app name, then choose read-only or allow changes.

Claude Code

claude mcp add --transport http pocket-archive https://api.pocketarchive.io/mcp

Then run /mcp in Claude Code, choose pocket-archive, and sign in.

Claude (web and desktop)

Open Settings → Connectors and choose Add custom connector. Name it Pocket Archive, paste the server URL, and select Connect.

Codex

codex mcp add pocket-archive --url https://api.pocketarchive.io/mcp
codex mcp login pocket-archive

Cursor

Add Pocket Archive to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pocket-archive": {
      "url": "https://api.pocketarchive.io/mcp"
    }
  }
}

Cursor opens your browser to sign in the first time it connects.

VS Code

Add Pocket Archive to .vscode/mcp.json in your workspace, or run MCP: Open User Configuration from the Command Palette to add it for all workspaces:

{
  "servers": {
    "pocket-archive": {
      "type": "http",
      "url": "https://api.pocketarchive.io/mcp"
    }
  }
}

Start the server from the file or the Extensions view; VS Code opens your browser to sign in.

ChatGPT

Turn on developer mode in Settings → Apps & Connectors → Advanced settings. Create a connector with the server URL and choose OAuth sign-in. Developer mode is a beta feature, and availability depends on your ChatGPT plan.

Connection details

For other MCP apps, or to check compatibility:

Use the client's connect/login action. It discovers OAuth metadata, registers its own name and callback URL, opens browser authorization, and exchanges the approved code for MCP credentials. The authorization page displays the registered client's name and callback host; each approved connection is granted and revoked independently.

If you are already signed in to Pocket Archive on the web in the same browser, the authorization page reuses that sign-in. Otherwise you sign in and return to the authorization request. The agent receives its own MCP tokens; it never sees your web session. Read-only connections expose read tools only. Settings → Connected apps in Pocket Archive lists and revokes connections.

A client needs remote Streamable HTTP and this OAuth flow to connect directly. A client supporting only stdio, legacy HTTP+SSE, confidential-client authentication or Client ID Metadata Documents needs an adapter. Not every agent product has been tested; compatibility is defined by these capabilities, not by product names.

Tools

Read-only connections see only the read tools. Allowing changes adds the write tools.

Documents

Attention items (deadlines, renewals and follow-ups)

Smart Collections

Example prompts

• "Find my Costco receipts from last year and total them."
• "Which warranties expire in the next three months?"
• "Upload this PDF to my archive and tell me what it is once it's processed."
• "Make a tax collection for 2026 and show me which documents are still missing."
• "List everything with a deadline this month and add a reminder for the lease renewal."

Use the Skill

skills/pocket-archive/SKILL.md contains agent-independent archive workflows: finding records, uploading files and waiting for processing, and downloading originals. An agent that supports SKILL.md can load this folder through its own skill installation mechanism. Other frameworks can use the instructions as task guidance alongside the discovered MCP tool schemas. MCP clients can call the tools without installing the Skill.

# Claude Code
mkdir -p ~/.claude/skills/pocket-archive && curl -fsSL https://raw.githubusercontent.com/ShisunXia/pocket-archive-mcp/main/skills/pocket-archive/SKILL.md -o ~/.claude/skills/pocket-archive/SKILL.md

# Codex
mkdir -p ~/.codex/skills/pocket-archive && curl -fsSL https://raw.githubusercontent.com/ShisunXia/pocket-archive-mcp/main/skills/pocket-archive/SKILL.md -o ~/.codex/skills/pocket-archive/SKILL.md

In the Claude app, download pocket-archive.zip and upload it under Customize → Skills. Code execution must be turned on.

The Skill provides workflow guidance; the host supplies MCP discovery, OAuth, credential storage, tool calls and any binary upload/download capability. If the host cannot perform binary HTTP transfers, the agent directs the user to upload on the web rather than claiming that a local file path was uploaded.

Files

• mcp.json: Agent Plugins MCP configuration with a streamable-http server. Use it in hosts that support this format; other clients should configure the endpoint in their native format.
• skills/pocket-archive/SKILL.md: shared workflow instructions.
• .codex-plugin/plugin.json and .mcp.json: optional Codex plugin adapter. The http type in this adapter maps to the same Streamable HTTP endpoint. Package this repository, including its dotfiles, as one plugin root following the Codex plugin format.
• skills/pocket-archive/agents/openai.yaml: optional OpenAI display and dependency metadata; other agents can ignore it.
• server.json: entry for the official MCP Registry.
• glama.json: maintainer claim for Glama.

A configuration file is not installed into an agent automatically. Include the adapter and Skill your client needs when packaging for it. This repository contains no credentials.

Privacy and security

Authentication follows the MCP authorization specification. Document text is your data and agents are instructed to treat it as data, never as instructions. See the Pocket Archive privacy policy for how your data is handled.

Support

• Setup guide: pocketarchive.io/ai-agents
• Help and contact: pocketarchive.io/contact
• Bugs or questions about this repository: open an issue
• Terms · Privacy

License

The files in this repository are released under the MIT License. The Pocket Archive name and logo are not covered by this license. Use of the Pocket Archive service is governed by its Terms.