
Ictfax MCP
Read-only fax tracking for ICTFax servers, with optional fax sending
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 2 days ago
About Ictfax MCP
Ictfax MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
The server logs in to your own ICTFax installation through the ICTCore REST API, using an account email and password, so it only works against a fax server you run or have access to. Two read tools are always on: one lists transmissions with their contact, status and direction, and one returns the status of a single transmission by id.
Sending is deliberately locked. The upload and send tools are not even registered unless ICTFAX_MCP_ALLOW_WRITE is set to true, because a sent fax dials a real number and can cost money. When enabled, the server handles the chain ICTFax needs: it uploads the document, creates the recipient and a send-fax program, then creates and sends the transmission.
It was written by the ICT Innovations team that builds ICTFax, which is GPL-3.0 open source software built on FreeSWITCH and ICTCore. The MCP server itself is MIT licensed and runs over stdio with Node.js 18 or newer.
Install
Run in a terminal
claude mcp add ictfax-mcp --env ICTFAX_BASE_URL='<ICTFAX_BASE_URL>' --env ICTFAX_USERNAME='<ICTFAX_USERNAME>' --env ICTFAX_PASSWORD='<ICTFAX_PASSWORD>' -- npx -y ictfax-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ictfax-mcp": {
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ictfax-mcp": {
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ictfax-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ictfax-mcp": {
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ictfax-mcp": {
"command": "npx",
"args": [
"-y",
"ictfax-mcp"
],
"env": {
"ICTFAX_BASE_URL": "<ICTFAX_BASE_URL>",
"ICTFAX_USERNAME": "<ICTFAX_USERNAME>",
"ICTFAX_PASSWORD": "<ICTFAX_PASSWORD>"
}
}
}
}Configuration
ICTFAX_BASE_URLICTCore REST base URL of your ICTFax server, normally ending in /api, e.g. https://your-ictfax/api.RequiredICTFAX_USERNAMEAPI account email (ICTCore logs in by email).RequiredICTFAX_PASSWORDPassword for the account.RequiredICTFAX_ACCOUNT_IDAccount id to send faxes from. Defaults to 1.ICTFAX_MCP_ALLOW_WRITEUnlocks uploading documents and sending faxes, which dials a real number and can cost money. When false those tools are not registered at all. Leave off unless you mean it.ICTFAX_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 30000.ICTFAX_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- ictfax_list_faxes
- List fax transmissions (id, contact, status, direction)
- ictfax_get_fax_status
- Status of one transmission by id
- ictfax_upload_document
- Upload a local PDF as a fax document; returns a document_id (writes only)
- ictfax_send_fax
- Send a local document as a fax to a number (writes only)
What it does
- Fax listing
- Lists transmissions with id, contact, status and direction.
- Status lookup
- Returns the status of one fax transmission by id.
- Write tools off by default
- Upload and send tools are not registered unless writes are explicitly enabled.
- Automated send chain
- Uploads a PDF, creates the recipient and program, then sends the fax.
- Configurable timeout
- Per-request timeout defaults to 30000 ms and can be changed.
- Self-signed TLS option
- An opt-in setting skips certificate checks for test servers.
Good for
- Ask an assistant whether a fax to a client went through
- Review recent inbound and outbound faxes on a self-hosted server
- Send a PDF to a fax number from a chat, after turning writes on
- Check transmission status while debugging an ICTFax integration
Pricing
Open source
MIT licensed server; ICTFax itself is GPL-3.0 open source
Prices change. Check ictfax.org before you buy.
Ictfax MCP FAQ
Can it send faxes by default?
No. It is read-only until you set ICTFAX_MCP_ALLOW_WRITE to true; the upload and send tools are not registered before that.
What does it need to connect?
The ICTCore REST base URL of your ICTFax server (normally ending in /api), plus an API account email and password.
Which tools does it expose?
ictfax_list_faxes and ictfax_get_fax_status, plus ictfax_upload_document and ictfax_send_fax when writes are enabled.
What are the runtime requirements?
Node.js 18 or newer; run it with npx -y ictfax-mcp or install it globally from npm.
Is Ictfax MCP free?
Yes. Ictfax MCP is open source, so you can use and self-host it for free.
How do I add Ictfax MCP to Claude Code?
Run this command in your terminal: claude mcp add ictfax-mcp --env ICTFAX_BASE_URL='<ICTFAX_BASE_URL>' --env ICTFAX_USERNAME='<ICTFAX_USERNAME>' --env ICTFAX_PASSWORD='<ICTFAX_PASSWORD>' -- npx -y ictfax-mcp
What are the best alternatives to Ictfax MCP?
The closest alternatives to Ictfax MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Ictfax MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity