Skip to content

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.

  1. 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.

  2. Add Plavn to your assistant. Settings → Developer shows a ready command and a ready mcp.json block 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.

  3. Ask. Try “What is due today in Plavn?”

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.