MCP server
Connect an AI assistant to your Plavn tasks, mail and notes over the Model Context Protocol.
Plavn includes a Model Context Protocol (MCP) server. Once an assistant is connected to it, you can ask in plain words:
- “What is due today?” or “What is overdue in the website project?”
- “What bugs did customers report this week, and which commits look responsible?”
- “Find the mail from Ana about the invoice.” or “Show me that whole conversation.”
- “What did I decide about the migration?” (searched by meaning in your notes and sent mail)
- “Add a task: send the report, due Friday 3pm, high priority.” (needs a write token)
- “Mark ‘send the report’ as done.” (needs a write token)
- “Prepare a reply to that email.” (needs a write token; nothing is sent)
The assistant uses the tools described in Tools reference to do this, as you.
Set up in five minutes
Section titled “Set up in five minutes”-
Create a token. In Settings → Developer, choose a name and Read only, then Create token, and copy it. It is shown once. See Personal access tokens.
-
Add Plavn to your assistant. Settings → Developer shows a ready command and a ready
mcp.jsonblock with your address; paste either into your client. For Claude Code:Terminal window claude mcp add --transport http plavn https://api.plavn.com/mcp \--header "Authorization: Bearer plv_your_token"Other clients are covered in Connect a client.
-
Ask. Try “What is due today in Plavn?”
Read or write
Section titled “Read or write”| Token access | The assistant can |
|---|---|
| Read only | List tasks, list customer reports, search mail, read a conversation, and search your notes and sent mail. |
| Read and write | Everything above, plus add a task, mark a task done, and ask Plavn to prepare a reply. |
Start with Read only. Plavn never sends mail through MCP: the most a write token can do to your mail is ask for a prepared reply, which waits in Plavn for you to review and send. See Security and privacy before you connect an assistant.
Related
Section titled “Related”- Tasks and prepared replies: what
prepare_replyandlist_customer_reportsbuild on. - Search: the words and operators
search_mailunderstands. - GitHub: where suspect commits come from.