Support

Do I need an AI account to use SHrimp?

No. SHrimp works as a regular task manager without any AI. If you want AI features, sign in with ChatGPT or add an API key for Claude, Gemini, Mistral, Grok, Perplexity, Groq, or OpenRouter in Settings.

Is it really free?

Yes. No subscription, no in-app purchases, no ads. If you use AI features, the provider's API costs are yours — SHrimp itself is free.

Where is my data stored?

Tasks are stored locally on your phone. If you pair with an AI agent, your task tree syncs through a Cloudflare Worker so your agent can read and write tasks. Email content (if you enable SHrimp Email) is stored temporarily and auto-deleted within 24 hours. See our privacy policy for the full picture.

Can I export my tasks?

Yes. Go to Settings → Export → Share Task List. You can export as Markdown, CSV, PDF, Calendar (.ics), or plain text.

The AI isn't responding.

Check that your AI provider is set up in Settings. If you're using an API key, make sure it's valid and has available quota. If you signed in with ChatGPT OAuth, try signing out and back in. If nothing works, email us.

I lost my tasks.

Tasks are stored locally, so deleting and reinstalling the app removes them — iOS doesn't preserve sandboxed data. If you had an agent paired, your last synced snapshot may still be on the server. Re-pair your agent and your tasks should restore automatically.

How do I install it?

Run claude mcp add shrimp -- npx @hermitsh/shrimp-mcp or add it to your MCP config JSON. Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible host.

Do I need the iOS app?

No. The MCP server works standalone in local mode with 13 tools — full task management stored at ~/.shrimp/tasks.json. Pair with the iOS app to unlock all 19 tools, phone sync, and push notifications.

How do I pair with the iOS app?

Open SHrimp on your phone → Settings → Agent → Pair New Agent. You'll get a 6-digit code. Tell your agent to run shrimp_pair with that code, or run npx @hermitsh/shrimp-mcp pair from your terminal.

Are there limits in local mode?

Local mode supports up to 500 tasks and 200 operations per day. Pair with the iOS app for unlimited use.

Which agents does it work with?

Any agent that supports the Model Context Protocol. Claude Code, Claude Desktop, Cursor, Windsurf, VS Code with Copilot, and others. If it can load an MCP server, it can use SHrimp.