# Valta Docs

> How to connect Valta to Claude, ChatGPT, Claude Code, Cursor or VS Code, what each of its tools does, and how vaults, notes and plans work.

Canonical: https://valta.si/docs

Docs

Last updated November 18, 2026

Valta keeps a vault of Markdown notes that every AI you use can read and write. Notes saved from Claude can be found from ChatGPT, Claude Code or Cursor, and the other way around. Your AI searches, reads, saves, links and moves notes in your vaults.

## Before you connect

- A Valta account. You can create it with an email address or with Google during the first connection.
- The Free plan gives you one vault. Pro and Team add more vaults, higher note limits and version history. Prices are on the [home page](https://valta.si/#pricing).

## Connect Valta

The connector URL is `https://valta.si/mcp`.

### Claude (web, desktop and mobile)

1. Open **Settings → Connectors**.
2. Choose **Add custom connector**, name it Valta and paste `https://valta.si/mcp`.
3. Click **Connect**, sign in to Valta and choose **Allow**.
4. In a chat, turn Valta on from the tools menu and ask it to save a note.

### ChatGPT

1. Open **Plugins** in the sidebar, click **Add** and choose **Add custom MCP server**.
2. Name it Valta, keep **Server URL**, paste `https://valta.si/mcp` and leave Authentication on **OAuth**.
3. Sign in to Valta and choose **Allow**.

### Claude Code

Create an API key on the Setup page in your Valta account, then run once in a terminal:

`claude mcp add --transport http valta https://valta.si/mcp --header "Authorization: Bearer <key>"`

### Cursor and VS Code

Add the server to `~/.cursor/mcp.json` or `.vscode/mcp.json` with the URL above and an `Authorization: Bearer <key>` header that uses a key from your Setup page.

## First steps

1. Ask your AI to start with Valta. It calls `account`, which lists your vaults and limits.
2. Give a vault a profile (who it is for, its voice and its rules) with `vault`. Your AI reads it before writing notes there.
3. Save something: “Save this decision to my vault.”

## Example prompts

- “Save the plan we just agreed on as a note and link it to my roadmap note.”
- “What do my notes say about pricing?”
- “Show me my vault as a graph.”
- “Move the meeting notes to my work vault.”

## Tools

Read tools only look things up. Write tools change notes or vaults.

| Tool | Type | What it does |
|---|---|---|
| `account` | Read | Your plan, limits and vaults. |
| `search` | Read | Searches a vault by words, with tag and kind filters. |
| `read` | Read | Reads a note, or a vault’s profile. |
| `recent` | Read | The notes changed most recently. |
| `graph` | Read | Your notes and their links as a graph. |
| `save` | Write | Saves a new note, or updates one (replace, append or prepend). |
| `link` | Write | Adds or removes a [[link]] between two notes. |
| `move` | Write | Moves a note to another vault. |
| `vault` | Write | Creates a vault or edits its name and profile. |

Saving under an existing title updates that note instead of creating a duplicate. With mode `replace` the old body is replaced; on Pro and Team, version history keeps earlier versions.

## Your notes are yours

Notes are plain Markdown. You can read and edit them in the Valta web app, and export them from your account at any time.

## Disconnect

Remove the connector in your AI app, or revoke an app from the Setup page in your Valta account. See the [Privacy Policy](https://valta.si/privacy) for what we store and how to delete it.

## Support

Email [support@valta.si](mailto:support@valta.si).

Questions? [Contact support](mailto:support@valta.si)
