Connect AI assistants

What assistants can do

Writa runs a remote Model Context Protocol (MCP) server. Once connected, an assistant can:

• List, search and read your notes and workspaces
• Create notes and add entries to existing ones
• Add task cards to a note, and tick or untick tasks
• Rename notes, move them between workspaces, and move them to the trash

Changes appear live in the Writa app on all your devices. Assistants add to-dos as task cards and keep them as simple checkboxes. They only set a status such as In Progress when you ask. Nothing is ever permanently deleted: trashed notes can be restored.

Server URL

Every assistant connects to the same address:

You’ll be asked to sign in to your Writa account the first time. There are no API keys or tokens to copy. In the Writa app you can also find this under Settings → AI Assistants.

Set up your assistant

Claude (desktop, web and mobile)

1. Open Settings → Connectors in Claude.
2. Choose Add custom connector.
3. Name it Writa and paste the server URL.
4. Choose Connect and sign in to Writa.

The connector then works in Claude on every device you use. On Team and Enterprise plans, an owner may need to add the connector for the organisation first.

Claude Code

Run this in a terminal:

Then run /mcp inside Claude Code and choose Writa to sign in.

Cursor

Add to Cursor

Or add a server in Cursor Settings → MCP with the server URL.

VS Code

Add to VS Code

Or run MCP: Add Server from the Command Palette, choose HTTP, and paste the server URL.

Other assistants

Any app that supports remote MCP servers over Streamable HTTP with OAuth sign-in can connect with the server URL.

Privacy and security

• Assistants sign in with your Writa account and can only reach your own notes, tasks and workspaces.
• Whatever an assistant reads from Writa is handled under that assistant provider’s terms and privacy policy.
• Assistants never receive your Google Calendar data.
• Notes mirrored from a code repository are read-only to assistants.
• To disconnect, remove the Writa connector in your assistant.

See our Privacy Policy for details.

Fair use

MCP access is for your own personal use and is subject to fair-use limits. We may limit how often or how much assistants can call the server, and we may change those limits or how MCP access works at any time, to keep Writa fast and reliable for everyone. Automated or bulk use that places an unreasonable load on the service may be throttled or suspended.

Troubleshooting

• “Writa Pro feature”: the account you signed in with is on the free plan. Upgrade in the Writa app under Settings → Account, then try again.
• Requests are slower or refused: you may have reached a fair-use limit. Wait a little and try again.
• Signed in to the wrong account: remove the connector, add it again, and sign in with the account you use in the Writa app.
• Still stuck? Get in touch.