Anam MCP Server

Official MCP (Model Context Protocol) server for Anam AI - manage AI personas, avatars, voices, and sessions directly from Claude or any MCP client.

Installation

Using uvx (recommended)

uvx anam-mcp

Using pip

pip install anam-mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "anam": {
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "anam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["anam-mcp"],
      "env": {
        "ANAM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Getting Your API Key

Sign up at Anam Lab
Navigate to the API Keys page
Click "Create API key" and save it securely

Available Tools

Persona Management

Tool	Description
`list_personas`	List all personas in your account
`get_persona`	Get details of a specific persona
`create_persona`	Create a new persona with avatar, voice, and personality
`update_persona`	Update an existing persona
`delete_persona`	Delete a persona

Avatar Management

Tool	Description
`list_avatars`	List all available avatars
`search_avatars`	Search avatars by name or description
`get_avatar`	Get details of a specific avatar
`create_avatar`	Create custom avatar from image (enterprise/pro)
`update_avatar`	Update an avatar's metadata
`delete_avatar`	Delete a custom avatar

Voice Management

Tool	Description
`list_voices`	List all available voices (400+ in 50+ languages)
`search_voices`	Search voices by name, language, or gender
`get_voice`	Get details of a specific voice
`create_voice`	Create a custom voice
`update_voice`	Update a voice's metadata
`delete_voice`	Delete a custom voice

Tool Management

Tool	Description
`list_tools`	List all tools in your organization
`get_tool`	Get details of a specific tool
`create_webhook_tool`	Create a webhook tool for API integrations
`create_knowledge_tool`	Create a knowledge/RAG tool
`update_tool`	Update a tool's configuration
`delete_tool`	Delete a tool

Session Management

Tool	Description
`create_session_token`	Generate a session token for the client SDK
`list_sessions`	List all sessions with optional filters
`get_session`	Get details of a specific session
`get_session_recording`	Download a session recording

Knowledge Folders

Tool	Description
`list_knowledge_folders`	List knowledge folders
`get_knowledge_folder`	Get details of a specific folder
`create_knowledge_folder`	Create a new folder for documents
`update_knowledge_folder`	Update a folder's metadata
`delete_knowledge_folder`	Delete a knowledge folder
`search_knowledge_folder`	Search within a knowledge folder

Knowledge Documents

Tool	Description
`list_knowledge_documents`	List documents in a folder
`get_knowledge_document`	Get details of a specific document
`upload_knowledge_document`	Upload a document to a folder
`update_knowledge_document`	Update document metadata
`delete_knowledge_document`	Delete a document
`get_knowledge_document_download`	Download a document

LLM Management

Tool	Description
`list_llms`	List all LLM configurations
`get_llm`	Get details of a specific LLM
`create_llm`	Create a new LLM configuration
`update_llm`	Update an LLM configuration
`delete_llm`	Delete an LLM configuration

Share Links

Tool	Description
`list_share_links`	List all share links
`get_share_link`	Get details of a specific share link
`create_share_link`	Create a share link for a persona
`update_share_link`	Update a share link
`delete_share_link`	Delete a share link

Text-to-Avatar (Early Access)

Internal Testing - This feature is in early access. Contact support@anam.ai for access.

Tool	Description
`generate_avatar_video`	Generate an MP4 video of an avatar speaking a script

Meeting Avatars (Recall Integration)

Add AI avatars to video meetings (Zoom, Google Meet, Microsoft Teams). Requires a Recall AI API key.

Tool	Description
`add_avatar_to_meeting`	Add an Anam avatar to a video meeting
`get_meeting_bot_status`	Check the status of a meeting bot
`remove_avatar_from_meeting`	Remove an avatar from a meeting
`list_meeting_bots`	List all active meeting bots

Configuration: Set RECALL_API_KEY environment variable alongside your ANAM_API_KEY.

Example Usage

Once configured, you can ask Claude:

"List all my Anam personas"
"Create a new persona named 'Sales Assistant' with a friendly personality"
"What avatars are available?"
"Generate a session token for my customer support persona"
"Add an avatar to my Google Meet call at meet.google.com/abc-defg-hij"

Default IDs

For quick testing, you can use these default IDs:

Resource	ID
Avatar (Cara)	`30fa96d0-26c4-4e55-94a0-517025942e18`
Voice (Cara)	`6bfbe25a-979d-40f3-a92b-5394170af54b`
Default LLM	`0934d97d-0c3a-4f33-91b0-5e136a0ef466`

Environment Variables

Variable	Description	Default
`ANAM_API_KEY`	Your Anam API key (required)	-
`ANAM_API_URL`	API base URL (for staging)	`https://api.anam.ai`
`RECALL_API_KEY`	Recall AI API key (for meeting avatars)	-
`MEET_PAGE_URL`	Avatar meet page URL	`https://meet.anam.ai`
`TEXT_TO_AVATAR_URL`	Text-to-avatar service URL (early access)	`https://anam-org--text-to-avatar-api.modal.run`

Documentation

License

MIT License - see LICENSE for details.

Development Status
- 4 - Beta
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language

Metadata

Development Status
- 4 - Beta
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language

Release files for anam-mcp 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anam-mcp 0.1.13
File	Size	Uploaded	Provenance
anam_mcp-0.1.13.tar.gz	80.7 kB	Jan 31, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for anam-mcp 0.1.13
File	Interpreter	ABI	Platform	Reset
anam_mcp-0.1.13-py3-none-any.whl 21.1 kB Jan 31, 2026 With provenance	Python 3	none	any	Details

Total release size: 101.8 kB

Release files / anam_mcp-0.1.13.tar.gz

Download URL	anam_mcp-0.1.13.tar.gz
Size	80.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`ef50d18e09f90ef859f29990c1fe7506ab5f75d374362b14ec7b90528fa50076`
BLAKE2b-256 checksum How to use checksums	`7da6bef4a8a972609f960641b875657184b24db66f7d0a58e0dc61b12a21755e`
Upload date	Jan 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/anam-org/anam-mcp
Publishing commit: github.com/anam-org/anam-mcp/tree/6e0b1c2d7e8e405a3702a177f5d185111f22d035

Workflow

Publishing configuration: github.com/anam-org/anam-mcp/blob/6e0b1c2d7e8e405a3702a177f5d185111f22d035/.github/workflows/publish.yml
Publishing logs: github.com/anam-org/anam-mcp/actions/runs/21546601837/attempts/1

Artifact

Subject: anam_mcp-0.1.13.tar.gz
SHA-256 checksum: ef50d18e09f90ef859f29990c1fe7506ab5f75d374362b14ec7b90528fa50076 Verifying attestations

Release files / anam_mcp-0.1.13-py3-none-any.whl

Download URL	anam_mcp-0.1.13-py3-none-any.whl
Size	21.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2a494c418b3e3c410da6aafbaa8ef3a97b2eebe313d12025fe499a81d2e74478`
BLAKE2b-256 checksum How to use checksums	`1e8189894e6960ada55ec373b3a5c676648e7aeb894fe8059c963311548aadf9`
Upload date	Jan 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/anam-org/anam-mcp
Publishing commit: github.com/anam-org/anam-mcp/tree/6e0b1c2d7e8e405a3702a177f5d185111f22d035

Workflow

Publishing configuration: github.com/anam-org/anam-mcp/blob/6e0b1c2d7e8e405a3702a177f5d185111f22d035/.github/workflows/publish.yml
Publishing logs: github.com/anam-org/anam-mcp/actions/runs/21546601837/attempts/1

Artifact

Subject: anam_mcp-0.1.13-py3-none-any.whl
SHA-256 checksum: 2a494c418b3e3c410da6aafbaa8ef3a97b2eebe313d12025fe499a81d2e74478 Verifying attestations

Security for anam-mcp 0.1.13

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for anam_mcp-0.1.13.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/anam-org/anam-mcp
Publishing commit: github.com/anam-org/anam-mcp/tree/6e0b1c2d7e8e405a3702a177f5d185111f22d035

Workflow

Publishing configuration: github.com/anam-org/anam-mcp/blob/6e0b1c2d7e8e405a3702a177f5d185111f22d035/.github/workflows/publish.yml
Publishing logs: github.com/anam-org/anam-mcp/actions/runs/21546601837/attempts/1

Artifact

Subject: anam_mcp-0.1.13.tar.gz
SHA-256 checksum: ef50d18e09f90ef859f29990c1fe7506ab5f75d374362b14ec7b90528fa50076 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.